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Application Sentinel 1 .1 
Application Asset Manager 2.0 
Document Revision 2 

Business or IT problem this feature solves (what) 

The changing dynamics of today's data centers require IT organizations to constantly evaluate and manage 
the runtime assets of their organization to achieve higher levels of system availability, manageability and 
interoperability. The Application Asset Manager (AAM) provides the overall integrated framework for 
managing the complexity of change associated with runtime applications and databases. Using a framework 
structure, Unisys has built integrated, domain specific tooling (i.e. Server Consolidation specific applications) 
to focus both consultants, when the tool is. used in consolidation engagements, and administrators skills to 
maximize the availability, manageability and interoperability of runtime applications executing on an ES7000. 

Where customers chose to use Unisys technical consulting services to assist in this area, the availability of an 
integrated framework will sharply reduce the Unisys cost of service delivery. The framework makes building 
and using domain specific tooling easier by providing a reusable structure for their construction and 
execution, thus allowing the builders and users to focus on the problem being addressed, instead of spending 
time recreating the common GUI interfaces or relearning new tools and procedures for each specific task. 



Functional Overview (how) 

The framework provides the ability to 

• Permit organizations to customize its behavior based on their own requirements. 

• Permit organizations to leverage the tools server-based events and triggers to provide 
additional levels of management for CMP-based systems (i.e. e-mail notification). 

• Support asset management, and deployment. 

• Version and catalog all runtime assets and the information about those assets of an 
organization in a centralized location using a full-featured version and configuration 
management system. 

• Provide a methodology neutral process for managing IT runtime assets in increasingly 
complex configuration environments. 

• Permit organizations to track incremental updates to changes, define relationships between 
such changes, and associate properties to any revision of any asset or configuration. 

• Permit for the automation and management of the runtime environment on ES7000 systems 
to ensure the deployment of better software systems with repeatabte success. 

• Provides full database back up and restore capability 

• Provides role-based security. 

• Reports and logs all user transactions against any asset in the database. 

• Provides full administration and management capabilities of the database using the Microsof 
Management Console. 

The framework will provide a rich set of asset management infrastructure capabilities, including: 

• Automated discovery capability to harvest system information [such as, number of 
processors, available processors, processor level, revision, etc] and information about 
running processes [such as, process ID, owner, creation time, handles, process and 
dependency versions and timestamps, etc.] on specified servers located in a server farm. 

• Automated discovery capability of SQL Server Database to facilitate SQL Server 
Consolidation. The information gathered is a detailed inventory of the customer's existing 
SQL Server estate, such as Servers, Instances, Databases, User and more. 

• Discovered information collected is stored in the application asset manager database and is 
available for detailed analysis by the analysis tool. 

• Analysis tool that interprets and generates reports from the information obtained during the 
discovery process. 



2 



• Generate reports that highlight opportunities for application consolidation and application 
coexistence. 

• Support custom report output, sorted in any manner, on any stored attribute. 

• Automated deployment of applications to one or many servers. 

• Automatic detection of installed software levels on distributed systems and the capability to 
bring them up to date, depending on deployment rules. 

• Automatic discovery and comparison of versions of installed applications across server 
domains. 

• The capability for Administrators to define hardware resource requirement rules prior to 
deployment of an application. 

• Scheduled based invocation of remote application and database discovery agents, with 
automatic import of remote output into centralized database, to permit time based analysis of 
applications and databases executing in a server farm 

• Scheduled based invocation of deployment tools to achieve higher levels of system 
performance. 

• Provide wildcard search, query and reporting capability on any revision of any asset stored in 
the database 

Competition, Positioning (why) 

Asset Management framework competition includes Microsoft Application Center 2000 and CA' Advantage 
suite. 

Microsoft Application Center 2000 

• Expensive - $3000.00 per CPU 

• Great for scaling-out, doesn't push scale-up at all 

• No versioning or configuration management support 

• No discovery tools for applications or databases 

• Not extensible 

CA 1 Advantage suite 

• More focused on application development than management 

• No discovery tools for applications or databases 

• Not extensible 

The use of the Application Asset Manager provides more opportunities for customers to: 

• Reduce costs in achieving effective system(s) utilization either through application and/or database 
consolidation or load balancing 

• Reduce costs in managing the administrative needs associated with enterprise class applications. 

• Quickly take advantage of new market opportunities by having a framework based, centralized 
location of application and database information, in order to quickly develop and implement new 
solutions that further adds value to overall data center operations 

• Increase application performance by ensuring all components are at proper version and revision 
levels 

• inventory existing applications, databases and associated component and configuration 
dependencies for consolidation, debug and/or reporting analysis 

• Inventory and monitor application, database and system performance thresholds over defined periods 
of time for workload analysis and sizing 



RDP Attribute Sheet Number. 5030 10 
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Application Asset Manager 

The Application Asset Manager (AAM) discovers and retrieves information on applications and 
ZSzSSHZ * ^ses T nlng an V where ,n an enterprise's computing fabric and can instantly 
ascertain their su.tabil.ty for consolidation and their affinity for one another in a consolidated 
environment. This is accomplished through AAM's Inventory and Analysis Manager. 

AAM Inventory Manager 

JEL A ^U? discovery i ? r inv f ntofV. Process is invoked through the AAM's Workbench Inventory 
View The process of Inventory is non-invasive. That is, the agent software is pushed to the 
£2 • « 1 B I ventorted and tne discovered data is sent back to the AAM database. Upon 
completion toe agents are removed from the target system. The entire process takes 
a iK C,ma ? y 2 ° seconds P er s y ste m. The information returned contains over 150 data points 
ncluding information on system hardware, applications and SQL Server databases. At this time 
the inventory process runs on the following Microsoft operating environments: 

All Windows 2K environments 

Windows 3K 32 bit environments (64 bit TBD). 

Windows NT 4.0 

Microsoft Windows 2K Terminal Services. 
Microsoft Windows NT Terminal Services is not supported due to dependency on the CITRIX OS, 
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AAM 2.0 WorkBench - Inventory View 




One can discover assets from one or many targeted servers in a single Inventory 
operation. One can also choose to perform more than one Inventory operation, each one 
targeting another set of servers. 

Using the Inventory View, the following Inventory options are available: 
• Inventory by Host Name 

This option enables you to select a single server for Inventory. You must know 
the name of the host machine, and a user name and password with administrator 
privileges. 



Inventory by Host List 



This option enables you to select a group of servers from a host list for Inventory. 
If you do not have an existing host list, you can create one after you selecUhis 
option You must enter a user name and password with administrator privileges 
for each server in the list. 
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Inventory by TCP/IP Subnet 
Inventory by Site Name 
Inventory by Domain Name 



Inventory Agents 

app.ca.on an. ~%£S^.?E5SSKK£^^ 
System and Application Agent 

^■S^^^^^^SSn?^ » ■» Pjocaas ofnanavtog moaadato 
and to ass*, in tha d-^S ^M'^^SdS SU " abKy ** co " M » <,a «°" 
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«P^HAwU>.fcidaP«fli : Siring 
cPBJ&M&toJD : Siring 
«P*L H <f»«M*_pereflUD: Stnng 
^P^MMaMatjaintafOnaemara : long 
6Pnj*t***b_**cBttioPTTXM JorW«k : long 
«Pf^HdWQife_procv3tc*UM* : Lang 
^^_HdMeM^_pracs3tfirRoOstan : tons 



*P3Jfctfcq_<MttN*n» : String 



$Pe^Gyi*rfD.fii»Vor : String" - 



cf^Sy'iKSpJO: String 
#P3_3y*tok>_cfl3Co«aVcri)ert : String 
*P^_Sy»W0_»y»lornN2TO« ; Song 
<yPC_Sy»t-!q,iy*!emMiAo : string 
oP3_3y*>£j_*y*!emModo» : Siring 
OP^_Sythfa^o3M^oVenton : Long 
oP^9y»Wo_MWW/-r»i5o : long 
cP fi^9ytK'3_<uGtUd : Long 
♦PE^BymWbjosRnv : String 
*P3_Sy*Hb_pogB3!xo : Long 
aPgjByrtrib_aBoc agonOBwteCy : Long 
$P ^_Sy» Wqjoid Mamery ; LongLeng 
^^JSyi.b-io_tTfzCc±itUmcrf • LangLong 

E_8 yi fr-.bjc* tfVbtu rfM smcry : LongLong 
^Oy*^«^«ot*Vbte(<UMnery : Ur^Lcng 
*PE_Sy***>JtotB< PogcR* : LongLong 



oPG_S jnWbjnotro>li>«J : Long 




^^^^^^^^^^^ 



^^^^^^^^^^^^^^^^ 



OPe_Proctr«5_tliVer : Suing 
$PE_Ptoc<im JbWerP«o> : Siring 
«F€_Ffocs»jD: string 




0pE_Proctj S3 _p» c j l virtue Glxo: LangLnng 
$PE_PtoeBM_pogaF«ittounl : Lang 
4^e_f»raCB3»_pe«kW0fWng3oiSiz« : LwgLong 
^PE_Procn3«_W(ofking3etSllq ; LongLorxj 
^PE_Prcc«»_c T joJnPo!*Pec»JPociU3ai5« ; Long 
$P5_Pioe«M jqudePegadPcxriUMBO : Long 
oP^_PiasMS M 4^eP«slNc^agadPaeaJuga: Long 
CP e_Procc»^_j^ot cN3nPoenc5>Doa>j *gs ; Long 
tf P^ja t Dco*»_p^aIloUiagi>: LcngLong 



0*^_Pioc««»j««lon [ String 
$P E_f^oc«» iJLOPeOt : Siring 





♦P£_Proc«j*Mdo. 


JnAssn.tAJorPish : String 
AAsstunoJd: String 
J(sAiMunaW»_D : String 




a.* 


a." 



Pg,Sy»Mbac 

<jPE_Sy*«b£*JD : String 



©PE_Sy«WbExj>nxjuclTypc t Pre 
^E^SyatrdB&UiuUMPKktop 



PEJn*iP»g 
#P^h3tPkg.Ua^er : suing"" 



^P^JmtPkgJO : String 
«P5jr»alPka_panjfqjD: String 



oP^_Otf*»_fitoVw : String 
tPEJZfaoJktOtfPdh i String 
«*Pe_CH*«JD : String 



0P^OrtvajcHwUfl» : String 
^5_Q4i»jK3lum*Nan» : String 
^P^_DrtM>_««teffksnbv: Lang 
0P5JDn*ouniDtFleFtexi*3tE» : Long 
OP£_OV»_Oc 3y » I smTyp* ; 3 twig 



4P D_QtwFlBB_paran^tO : J 
5P^_Qh«FJ(i9jtagVrfo. : t 



Pg_ModH» 



«Pe_MarfJo OaVcf : String 
OPG_ModtiOria*Paih : SMng 
dPE_Malu!»_vcrrion : String 
OPE_Modt*iJD : String 



gPE^Modtiajtx* : Long 
0P^_MttMt_jnaRtaryMeppsd : Bodasn 



Orange tables indicate new features in AAM 2.0 for Application Sentinel 1.1. and is not part of 
AAM 1.1 released to TCS 
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SQL Server Agent 



H?int!nLt!d r ? atabasB ?9ent was designed to assist in the process of retrieving those data 
SQL Server Database Agent facilitates the capture of a detailed inventory of the client'* ^M; nn 
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Logins 
(from tea) 



S3 



mach!ne_name : VARCHAR(25B) 
server name : VARCHAR(255) 
LoglnName : VARCmR(5lO) 
SID:VARCHAR{688) 
DefDBName : VARCHAR(510) 
< DefLangName : VARCHAR(5lp) 
AUser:VARCHAR(5lO) 
ARemote : VARCHARfSIO) 



instjogi 



1..n 



ns 



SQLjndances 
ffmmtesl) 



Databases 
(from tost) 




MachlneName : VARCHAR<255) 




Server^ me : VARCHARpSS) 




name : VARCHAR(512) 




cvvner:VARCHAR(512) 




created : VARCHAR(510) 




status: VARCHAR(2400) 




eompaiJbWtyJevel : VARCHAR(510) 


logsze : REAL 




logspaceused : REAL 




l&!atus:VARCHAR<255) 




dbsze : REAL 




unalloc_s:R£AL 




reserv s: REAL 




data s: REAL 




Indexes: REAL 




unused_sp : REAL 




transpubllsh : INT 




mergepubllsh : INT 




dbowner : VARCHAR(255) 




readonly : VARCHARgSS) 







MachlneName : VARCHARC255) 
Sen/erName : VARCHAR{255) 
ProductName : VARCHAR(255) 
ProductVenion :VARCHAR{255) 
Language : VARCHAR(255) 
HleDescrfpUon : VARCHARC255) 
RleVerdon : VARCHAR<255) 
IntemalName : VARCHAR(2S5) 
OrtglnalFllename : VARCHAR{255) 
PrivateButld : VARCHAR(2S5) 
SpedatBuild : VARCHAR(255) 
WrtdowsVerdon : VARCHAR(255> 
PiocesaMCount : VARCHAR(255) 
Processor AdiveMaA : VARCHARC255) 
Physical Memory : VARCHAR(255> 
CoUation : VARCHARpSS) 
Edition : VARCHAR<255) 
tsCtodered : VARCHAR(255) 
IsFullTextlnstelled : VARCHAR<255) 
IsWegratedSecurltyOnly : VARCKAR(255) 
IsSlngleUser : VARCHAR(255) 
IsSyncVUlhBaehip : VARCHAR{2S5> 
UcenseType : VARCHAR(2SS) 
ProdudLevel : VARCHAR(255) 
awe_enabled : INT 
max_server_memory_MB : INT 
mi n_server_memory_M B : INT 
ShortProducfVeriJon : CHAR<4) 



tnsiAterts 



0..n 



Inst DBRdes 



Alerts 
(from ted) 



MachlneName : VARCHAR(2S5) 
Server Name : VARCHARpSS) 
name : VARCHARGSS) 



1..n 



08_Rotes 
(from test) 



machlne.name : VARCHAR(255) 
server _name : VARCHARt255) 
Loginttjme : VARCHAR(510) 
DBName : VARCHAR(510) 
UserName : VARCHAR(510) 
UserOrAlies : VARCHAR(510) 




MacHneName : VARCHAR£55> 
ServerName :VARCHARC255) 
name : VARCHAR(255) 
owner : VARCHAR(256) 



ServerRoles 
(from test) 



MachlneName : VARCHARC255) 
ServerName : VARCHAR(255) 
ServerRole : VARCHAR(256) 
MemberName : VARCHAR(256) 
MemberSID : VARCHARC344) 
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(from test) 



MachlneName : VARCHAR(255) 
ServerName : VARCHAR(255). 
name : VARCHARC256) 



\ .tnstjj$p > 


0 

USPMasterDB 


MachlneName : VARCHAR(255) 
ServerName : VARCHAR(2S5) 
USPName : VARCHAR<255) 
Owner :VARCHAR(255) 


0-n 





Machine Name : VARCHAR055) 
ServerName : VARCHAR(25S) 
orlglna llng_serve r : VARCHAR(255) 
: VARCHAR(256) 



Non_De fa uJt_^x:on figures 

(from test) 

MachlneName : VARCHARpSS) 
ServerName : VARCHARC255) 
PName : VARCHAR(255) 
OefaultJ/alue : VARCHARf255) 
Minimum : VARCHAR(255) 
Maximum : VARCHAR(255) 
ConflgLvaiue ; VARCHAR(255) 
Run value : VARCHAR<255) 



All tables indicate new features in AAM 2.0 for Application Sentinel 1.1. and is NOT part of AAM 
1.1 release to TCS. 

i 
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AAM Analysis Manager 

The AAM Analysis Manager permits organizations to analyze one or many inventoried systems 
simultaneously relative to system hardware, application and database configurations in a 
Microsoft Windows operating environment to highlight opportunities for application consolidation. 

The Analysis Manager is invoked from the context of the AAM WorkBench after selecting the 
file(s), or revisions thereof, representing the system(s), applications and SQL Server databases 
inventoried. 



Asset Management Analysis vs. Consolidation Analysis 

The AAM Analysis Manager provides organizations the ability to view the assets of one' or more 
systems simultaneously for either asset management purposes or server consolidation purposes 
This ability is depending on the licensing purchased. 

The Asset Management capabilities in the AAM Analysis Manager include: 

• Ability to list, compare, contrast, and associate discovered data including system 
hardware and software configurations, applications/databases (installed and executing), 
executing application dependencies, and relationships of dependencies. 

• Ability to associate executing components with any Microsoft products and product 
versions 

The Consolidation capabilities include all the capabilities included in the Asset Management 
Analysis as well as the ability to: 

• Indentify common applications and databases based on names, versions and 
timestamps. 

• Identify opportunities for consolidation success based on OS types in the server farm 

• Indentify opportunities for scale-up systems based on number of processors in the server 
farm 

• Ability to determine application/database best fit analysis based on target system 
average CPU utilisations. 

• Ability to highlight compatibility issues based on applications running on the target vs 
proposed applications to be migrated to the target 
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Application and System Analysis 



>*■ Unis ^ Appl i cation Asset M^aqe^Ana^ ^^,'^:!fW<^M 




This screen is part of the Consolidation Plug-in. The Analysis Manager provides one-button 
analysis relativeto common applications, common executing processes and common executing 
dependencies. The user can visually determine the degree of difficulty to consolidate those 
applications executing on those servers selected for analysis 



o 
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is. Unisys Application Asset Manager;* Ana lysis? Mqn^Vd^i^^^^^^ 




This screen is part of the Consolidation Plug-in. The Analysis Manager provides one-button 
analysis relative to Systems by Number of Processors and Systems by OS Type. System's by 
Number of Processors indicates scale-up opportunities while Systems by OS Types indicates 
potential complexities associated with cross OS application consolidation. 
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SQL Server Database Analysis 

The standard set of reports include: 
Instances 

E^££K£" * ^ nUmbW ° f SQL Server instances broke " *"» by 
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Sp_configure 

Unique DBs^ n ° ri " default ""^Suration parameters by server. 
Database sizes 

Collatiorf hOWS am ° Unt ° f space actua,| y be,n 9 used b V each database. 
Logins ,nC " CateS *** SOrt ° rder and 001,6 P a 9 es being used by each SQL instance. 
Default SSS^**" ^ *" ^ P°P utetion - 

*££ SbS. HaVe ' 09inS ° n ^ ° ne Server but ■»«0 n - d with a Afferent 
Server roles 

Server .STSSSw?"™"* "* r ° ,eS m3y h " Ve be6n 3SSi 9 ned to a lo 9 in - 
Servers Sh ° WS ,denttoal ,ogins on mu,H P ,e servers D "t with different server roles. 

Disk Storage 

~ T j ? ta,sof s Pace used and free for each logical drive 
SQL Configuration 

Highlights non-default sp_configure settinas 
Databases 

stSetc 6 dat3baseS resident on that serv * r - details of database and log space used, 

Highlight of potential consolidation conflicts 

orM . 3' 9 ' ro,es ' Databa se roles, default databases 

SQL Jobs and Tasks 

List and highlight duplication. 
SQL Alerts 

List and highlight duplication 
SQL Operators 

List and highlight duplication 
DTS Packages 

List and highlight duplication 
Replication 

Indicates those databases where replication is allowed 
User Stored Procedures in the Master Database 
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C^A**» fai vfr&w* NT ^SdaSKT 
.OL«rt Agjrtjpi Window NTV ' ~~ 

IcA^od^ NT i 
-C^SiAow* '<* Wndowj NT ana <uuu 
C5e# Agwii faWbTdrwx NT aFid 2000 
C^Agen^fa Window, NT *Sd2bOO 



ARC*e£yc20CQ 
JMC|oKw»e 



tuvngs 



TE GU 

jtimpT" 



CentpStege FVojpcra 4.1'_. 7flgj[ 





■i . mm 

t^T2Dao3 * — IBIS 

turn?- zr~-'i.r' - Wat 



£^^J« Window* NT *nd 2000 ,M£MBA~ 



J^ 1 !?^^^^^ MabrUay^o gigged — 
.'r9?^^a<W^As^ 

g Compaq Wenegeroenl Agirtt r£feETAH 
S £^M*«*e^^ KffiKff* 



REN 
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P^HAws into 



0PE_Hdwetnft> faeVer : String 
$PE_Htf*reinro_rotderPath : String 
tfP^HdvrttafoJD : String , 
0p£_HrtweWo .jwremJD : String 
^E_MdweInto_numbeiCtfPraces3or3 ; Long 
^EJH&rtWojBvaStitiiePioccssoaAasM ': Long 



^EJKdwetnto^jTOoessoiRevi&ion : Lang 



F 1 " 



JUi- 



PE_oevtoB 



^PEJ^eYiceJiteVer : String 
^^OevtaLfoiteiPaih : String 
d PE -Dcvtoq_parent_lD : String 
$PE jJevicojteviceName : String 
<?P^Dcvfce_devtocLo cation : String 
c?Pn_Dcvico_cmpLcca 4 ion : String 



Hamaro m J>ro vsso/Spoeds 



PE_Syslnto 



^E_Sy3firdbJBDVcr : String 
OPE_SystnfoJo Woj Path t String 
^PE.SydnfojD : String ' 
ePB^SyslofojilscovQfVcfStoti : String 
^PE^Systnto^captufeTbneQMT : Strtng 
^e^Syslnto^captureTtmeNurnerie : ling 
$PE_S y&inlQjSYStemNamg : String 
^EjSystnto <> .systemMaXB : String 



^E_Systnto_csMaJoxVefsfcn : Long 
^PE_Systofo_osMtnorVcrsicwi : Long 
0PE_SysInIo_asBiifk} : Long 
ePEjBysHmojisRav : String 
^PE.Systnto jMseSfae : Long 
oPE-Sy^tnto^attoeaUortGrantiiarfty : Lang 
0pE^Sysin!ojnt2lMamory : LongLong 
^PE_SysInft)_availab;oMBmofy : LongLong 
^E^SyslnfbjotalVtrtualMfirnory : LonaLong 
4PEjSysln!o_av3feb}oVtrUaMemoiy • LongLong 
^PEjSystnTojotalPageFao : Longing 
^PE_Syslnto_avaaatteP3flef iie : LongLong 
0PE_Srslnto_mcmorylo3a : Long 



Pg_AppCatatogRern 



TT 

System^ AppCctibg 



<^P E_A p?C oteJoa_rj isVei : String 
^PE„AppC3tatog_rolderf»aih : Siring 
<>PEjVppCatatog_parcnUO : Strin 3 ' 
^PE>ppC3tatog_appNarr» : String 
^E.AppCatatofl_appVerstQn : String 




$PE_P*ocess«eVer : String 
^PE_Praces3joWcrPath : String 
<>PE_ProeessJD : String 
^PE_Proce ssjiarentSystem CD : String 
<>PE_Proce£s_pn>ces5NaiDo~ String 
OPE_Proce&s_proccssld : Long 
$PE_Process_deptn : Long 
^PE.Pmoes^fiWtyMask rung 
<>PE_Proce5^i)T0C06SOwnc f : String 
OPE_ProcEs^_pafBmProcess id : String 
$PEJHocBs$_5tartTlme : String 
^PE.PfDcess.handleCoum : Long 
OPE_ProCB5s_basePrionty : Long 
^E - Pro««s_cpuTlm8: LongLong 1 



PE.SystatoEx 



^Pe^SystnfoEJt^DteVei : String 
^PE^SyslnroEjefoVJcrPath : String 
^PE_SyslnfcEj^IO : String 
O P£_Sys l rtTo Ex_p-an: n'J D : string 
^PE^SyslrtfoEj^servlcePailMsJOJ- : Long 
^PE^SysInfioEX-ScvJcePadtMinQf : Long 
^PE_S yslnfo&tjjradudTypo : ptodudType 
^P^SysfatfoEj^instafledPagkage : PackagoTypes 



OPE_Proccss_rmsServiccs : Boolean 
^PE_Process_cvwiProccss : Boolean 
^PE_ProcOEsj>e3kVimaJSJre : LongLong 
^E^Proces^jagcFauaCount r Long 
^PE_Procet5_peakWorWngSet5ao : LongLong 
^E_ProcessjirorMngS«Sfee : LongLong 
OPE_Process_ qU DtaPeatPagedPoafUs3oa : Long 
^PE_prDces^_QuotaPngedPDOlUsage : Long 
^PE_ProcBsS(_QiJOtaPeakNonPagedPoolUsaoa : loi 
^Pe.Piooexs^quotaNonPagedPDOlLfsaee : Long 

J*roces^_pagefilcUaago : LongLong 
^Pe.ProcessjjeakPaflefiteUsage : Long' 
OPe_Procc33_prfvatePagcCount : Long 
^PE^Process^veralon : String 
dfE_Proco5s_descr!pOon : String 
0P£j>ro cccs_ruCPatti : String 



PEjrocessModubAssn 



^PE.ProcessModuteAssn^niaVex ; String 
^PE_ProcessMdcuieAssn_faWExPath : String 
OPE_PracessM«3uteA5sn_prac_td : String 
^EJ > ioeessMooiileA«TuniocftriQ,lD : string 



Modvlo_ofPrx>CG ss 



SyxtnfoE r_PAgj 



PEJnstPkg 



<>PE JnsiPkQjile Vcr : String 
^PEJnsiPkgJoidecPolh ♦ String 
$PEJnstPkgJD : String ' 
0PEjnstPlc a _oarenUD : string 
pPg_tnstPAa-va2us : String ' 



PE_I 



^PE_DrtvBjiteVw : String 
<>PE_DnN« joirfeiPaih : String 
ePEJDmoJD : String 
^PE - Orivq_parta^_lO : String *. 
^PE_DrrwB_rfnVc Letter : String 
^PEjDrivejrafumeNarria : String 
^PE_Orive_cerialNumber : Long 
^EjDriva.maxFBeNaniaStee : Long 
^PEuOrtv9_nieSystemType : String 
<?P£_Dfh/o_tQfi8ytE5 : LongLong 
gPgJOiBnyJhMBytea : LongLong 




PE^Module 



$PE_Modute titeVer : string 
$PE_Module_folderpatr» : String 
^PE_Module - vwslon : String 
^PE_Mo<hio_fD : Suing 
^PEJtlodutejmeroJO: String 
lPE_Modtde_base : LongLong 
0PE_Modtde_sfco : Long 
^E_Moduto_mernoryMapped : Boolean 
^PE_ModuJc_cre ationTIm© : String 
^PE_ModuJo_motlutcDc scriptkMi : Suing 
4>PE_Modute_palh : String 



File: E:\AAM Patenls\NPE_AAM2.0.mdl 10:16:07 AM Thursday. February 27. 2003 Class Diagram: ProcessExpiorer / ProcessExplorer Page \~l 
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Application Asset Manager 



Application Asset Manager - Overview Topics 

Application Asset Manager and Server 
Consolidation 

Many IT organizations are looking to consolidate applications, databases, and systems to canitalize on the 

and admunstration of large server farms. To evaluate the potential benefits of server consolidadon TT 
orgamzatrons mnst first profile the applications running on thek distributed siX. ^ 

^ A ZSZ ati ° a ^ Man i ger *** ^ovvy analysis tools dedicated to profiling applications These 
2£T?E A ° P r te yOUf n ° teb00k com P uter > which ^ connected to ttSSST 



c^rition^iS^T 68 iD ?f mation ftom aU P»>fi»ed servers to reveal the potential 
consol danon candidates and any possible consolidation conflicts. The results of the analysis can be 
presented to the customer in various standard report formats. * 

These Application Asset Manager tools also can be used to monitor the run-time applications in an 
3™? n S s f™ fa ™ 0° an ongoing basis, ensuring that all application^mpSneSTe ru^mng at the 
proper revision levels and that system resources are being used effectively. 
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Server Consolidation Features 

The graphical user interface (GUI) of the Application Asset Manager is integrated with Microsoft Windows 

2S^ ^^5!!^ ^ ,WerfaCe With a ^ view P"*"**" greatly enhances the ease- 

of-use of thus tool The menu items function similarly to the menu items found in Windows Explorer with 
two important additions: the Server Consolidation Tools and AAM menu items. Their drop-down menus 
he p you easily find the functions you need. The Server Consolidation Tools drop-down menu specifically 
lists the tasks you need for performing server consolidation. y 

In addition, two wizards help you configure the Application Asset Manager and perform the subsequent 
application profiling process. The Configuration wizard helps you configure the ApplicationAsset 
Manager database to support application profiling, and the Discovery wizard automates the capture of your 
customer's run-time assets, ehrrunating the expense and drudgery of discovering these assets machine by 
machine, a manual process that can take days or weeks. When the discovery process is complete, the 
remote agents launched into the network terminate, leaving no trace on your customer's system. 

Server Consolidation Benefits 

Some of the benefits to using the Application Asset Manager for server consolidation are as follows: 

• You can quickly profile applications and perform unlimited queries on captured server assets 
using the discovery and analysis tools. 

• Thorough, detailed analysis reports are based on a discovery process that is tailored to your 
customers requirements. ' 

' ftSibkf 161)0115 Cnable y ° U y ° OT customer to easily Ermine whether server consolidation is 

• If server consolidation is feasible, customers can reduce costs by achieving effective system 
utilization through application consolidation, or load balancing. 

• Customers can increase application performance and reduce the chance of application failures by 
ensuring all components within their systems are at the proper version levels. 

• Customers can inventory and monitor applications and system performance thresholds over 
defined penods of time for workload analysis and sizing. 

• Customers can reduce administrative costs associated, with enterprise-class applications. 

Discovery Overview 

Discovery is the process of harvesting system information and information about running processes on 
specified servers located in a server farm, and storing the information in the Application Asset Manager 
database. You can run the discovery operation on any predefined project or folder. 

The discovery operation requires you to complete the following tasks: 

• Enable the server consolidation tools option 

• Create a project or folder in which to place discovered assets. 

• Define properties for the project or folder, including configuration of the discovery execution 
sequence. 

• Initiate the discovery process. 

The discovery operation requires the customer to make available an existing user ID and password or create 
a new user ID and password for the servers you are targeting for discovery. The user ID must have 
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ad^trator privileges and can be removed from the systems as soon as you have completed the discoverv 
St^l T 0Pera 1 ti0n fmishes on «* tog* server, the agent is removed frZ the se^erTd S 

™1^Z ?° m J OUI ,apt ° P * tera ^ ated - fa ^nimary, no trace of the discovery operation wil? 
remain m the customer's system, r 1 

Abte.- 77,e administrator privileges must include the rights to debug programs and to load and unload device 

Once you have enabled the server consolidation tools option and created a project or folder you can use the 
.Discovery wizard to define the servers whose assets you want to harvest. The Discovery S ZncheTa 
remote agent mto each designated system to capture information about all of the apphcS Sprocies 

5SE Ale wSI^H 3g T T te f- ^ C3ptUred infonnation back *> notebook ^ute^ 
™T * 15 st ° red m the Application Asset Manager database. As previously stated, the remote 

agent is removed from the target server, leaving no trace on your customer's system. 

ISKiT ° VerieS ^ ^ d ° ne b y, sche<iulin 8 ^very at specific time intervals to capture those 

P ° r pr ° CeSSeS *»* ™ on jy at a P^icular time. You can also run the discovery operation again 
manually. Each time you repeat the discovery operation, you create a new revision of the server XML file 

§ aVailab,C i0 * e VeiSi0a ^ ° f App,iCart0D Asset Manager proScTor 

Types of Discovery Information 

The types of information discovered include hardware information, such as 

• Number of processors on a given system 

• Available processors on a given system 

• Processor level and revision 

System information' discovered includes the following: 

• System name 

• Page size 

• Operating system version 

• Operating system build 

Process and dependency information discovered includes 

• Active processes and their associated dependencies (both component and configuration) 

• Processor usage at bom the system and the process level 

• Memory usage at both the system and the process level 

• Process creation time 

• Process ID 

• Process owner 

• Process handles 

• Process and dependency versions and timestamps 
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• Process and dependency descriptions 

Analysis Overview 

^^ 3 vi? t0 ° ] ******* t n i S enerates «P0rt8 from the information obtained during the discovery 

2 i:™:r of ? files ' inc,uding revisioos ° f - * H SZS *e 

analysis process to focus on any subset of discovered server assets. Once you have opened the set of 
discovery files, the Analysis tool summarizes the number of systems and U^^^S^ ■ 

InnlSin? J? f nera ,? S ** * gWifiht °PPortunities for application consolidation and 

S?^?Lc SP"? F ° r * e Common Processes lists the processes running on two or 

i ' f3,m A PP ]ications associated with common processes arTc^sohSation 

candidates. The Analysis tool provides custom report output, sorted in any manner, on any «|«SS2L 

You can produce customized reports based on queries of any of the following data elements: 

Hardware Information 

• Number of processors on a given system 

• Available processors on a given system 

• Processor level and revision 

• Devices on a PCI bus 

• Non-network disk drives on a system and characteristics of the drives 

System Information 



• System name 

• Operating system version 

• Operating system build 

• Total and available memory 

Applications 



Application name 
Application version 



Processes 

• Process name and process ID 

• Process owner 

• Process dependencies 

• Process and dependency descriptions 

• Process and dependency versions and timestamps 

• Actual memory and virtual memory 

• Memory paging 

• . Processor usage 

• Actual CPU time 

• Number of handles open on a process 
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Summary 

oaraoase. ino trace of the agents or the discovery operation is left in your customer's system. 

# I 0 "?^? 6 *? 3lySiS 1001 ^^tely, or you can choose to run the tool later. Once you have 
completed the analyse process, you can generate various reports and deliver them to your 
customer withm hours. It's that straightforward! y 

Application Asset Manager Online Seminars 

Application Asset Manager - Installation & 
Configuration 

Pre-installation Requirements 

mSmutra^^ 

" f 1 )- 61 Pentium n Proctor or compatible processor (at least 300 MHz) 

• Microsoft Windows 2000 operating system 

• At least 1 92 megabytes (MB) of RAM 

• At least 700 MB of free disk space 

• Total page file size o f at least 500 MB 
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Installation and Configuration Tasks for 
Application Asset Manager 

Complete the following tasks before using the Application Asset Manager. 

Login User Account 

^T,? 16 S ta S? n8 J? ,B ^PP Ucation •^ sset Manager on a notebook computer that might be profiling servers 

°*-7 h ? 1116 - B m y ° U n0nnal,y Io S 111 10 > ^ roust insta » und «" * user acco?n™h 
complete adnumstrator pnvileges. Use this same local account for configuring the Application Asset 
Manager database. If you are on a workstation that will not be moved ainong^Lim^u^e^ur 
normal login account for installing the Application Asset Manager , you can use your 

Setting User Account Privileges for Configuration 

mW P ^ Cati ° n ^ SSet Manag ? r Confi S uration <»» * system running Windows 2000, you must 

be an administrator on that system with specific user rights. '™ 

Required user rights depend on whether your Windows logon user ID and Application 
Asset Manager configuration user ID are the same or different. 

If you are configuring the Application Asset Manager with the same user ID under which 
you are currently logged in to Windows, Ihen 

1. The user must be a member of the Administrators group. 

2. The Administrators group or the user must have the following privileges: 

^ a. Act as part of the operating system 
b. Log on as a service 

*w°- U ^ confi S urin g the Application Asset Manager with a user ID (e.g., "AAMUser") 
^nut^rthen ^ *" Und6r **** ^ cmaA y lo & ed into Windows (e.g., 



1. 

2. 
3. 



AAMUser" and "WinUser" must be members of the Administrators group 
The Administrators group or "AAMUser" must have the privilege to "Log on as a service"! 
The Administrators group or "WinUser" must have the following privileges: 

a. Act as part of the operating system 

b. Create a token object 

c. Increase quotas 

d. Replace a process level token 

To verify that a user account has the correct user rights, perform the following steps: 

1 . From the Control Panel, click Administrative Tools. 
The Administrative Tools window appears. 

2. Select Local Security Policy. 0 
The Local Security Settings window appears. b 

3. In the left pane of the Local Security Settings window, expand the Local Policies folder. 
A User Rights Assignment folder appears in the left pane. 
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4. Click the User Rights Assignment folder. 

A list of user rights appears in the right pane. ^ 

5. In the right pane, find a user right, such as, "Act as part of the operating system 4 ' (in the Policy 
column). 

6. Examine the Effective Setting column to ensure you have this right. 

7. Repeat steps 5 and 6 for all user rights required for each account. 

For each required right, such as "Act as part of the operating system", that is missing from a user account or 
user group, perform the following steps. 

1 . Double-click Act as part of the operating system in the right pane of the Local Security Settings 
window. 

2. Click Add in the Local Security Policy Setting dialog box. 

3. In the Select Users or Groups dialog box, find or type your user account or user group, and then 
choose OK. 



^^Note: If a user account or user group appears .in the Local Setting column but not in the Effective 
Setting column, you need to log out of the Windows environment and log in again to make this setting 
effective. 

4. Close the Local Security Settings window and the Administrative Tools window. 



Using the Configuration Wizard 

Once you have installed the Application Asset Manager, use the Configuration wizard to configure the 
Application Asset Manager database before performing any server consolidation tasks. 

You can access the Configuration wizard through the Start menu. Point to Programs, Unisys, Application 
Asset Manager, and then choose Configure. The wizard includes online help, which has step-by-step 
procedures for all of the server consolidation tasks. 

To size the Application Asset Manager database for server consolidation using the Configuration wizard, 
you must estimate how many servers you will be discovering before you begin. Each discovered server 
results in a new file in the Application Asset Manager database. 

The default database size is 10,000 files, folders, and projects. This is equal to the discovery of about 
10,000 servers. The maximum size is 1,000,000 items, and the minimum size is 1,000. The default database 
size is sufficient if the number of servers you are discovering is less than 10,000. If you are discovering a 
small number of servers, you can reduce the database size to the niinimum size. The Configuration wizard 
will not allow you to create a database smaller than 1,000 files, folders, and projects. 

^Note: Once the wizard begins configuring the Application Asset Manager, it can take 15 to 30 minutes 
to complete the database configuration. 



Download the Application Asset Manager: IC4 

Download the Application Asset Manager here and check out its features and capabilities. We also would 
you to send us your feedback. The download is not password-protected, but this form helps us track who i 
using the Application Asset Manager. Thus, we can notify you about upgrades, support issues, and fixes. 



24 



servers 



First, fill out this brief registration form. Asterisked items are required fields. 

System Requirements 

• Microsoft Windows 2000 operating system 

• Intel Pentium II processor or compatible processor (at least 300 MHz) 

• At least 192 megabytes (MB) of RAM 

• At least 700 MB of free disk space 

• Total page file size of at least 500 MB 

Login User Account 

you are installing the Application Asset Manager on a notebook computer that might be profiling ser 

ZSE?S ^ T y ° U n0rmally ,0 S * to ' *» mus * instaU under a loJuser account 
complete admimstrator privileges, which includes the right to act as part of the operating syTenT 

worlSfn^ 1 ? Cal ,? CC T t fOT co j lfi 8 ur 'ng the Application Asset Manager database. If you are on a 

Installation 

n^Z^* ^ "^ LS :^ SpeXe " <2S ^ to a !«cal directory. This file contains the installation 
Cfw : Ex ^ ute *t^ ,e ^S^P-^^executionextmctsttefilesneededforthe . 
Sued° n * q ° n,y f ° r l0Cati0n Wh6re y ° U want &e A PP««tion Asset Manager 

Upon completion of Application Asset Manager installation and database 

Release Notes for Application Asset Manager 1.1 
IC4 

SSS^^^E^^^^* 1 ^ 11 ^e ri mC OI rection(IC)4and replace the 

Installing the IC 

To update the Application Asset Manager 1.1 to IC4, complete the following steps: 

1. DownloadthefileAAMSetup.exe. 

2. To install, double click AAMSetup.exe or run the installation from a command window. 

• If the Application Asset Manager is not installed, the installer will guide you through the setup 
p roc ess . 

" i I ^P;7 o f v « rei0no f Application Asset Manager 1.1 is installed, you are asked if you want to 
update to Apphcation Asset Manager 1.1 IC4. Select Yes to continue with the installation. 



25 



on 



Changing Your Password 

services to run. SSSJjST 1«!2S£ ^ 8 T ace . 8 f d * e Ure P Inetd serv ^e to allow the database 

Manager database J^SjX^SjEff ^ °? *?• k »? t0 f 8 A ™ l ™ tio « Ass * 
Administrative Tools utility. g password ""W Application Asset Manager 

i 

Changing Your Ureplnetd Password 

Perform the following steps to change your password in the Ureplnetd service: 
1. Right click My Computer and select Manage from the shortcut menu. 
The Computer Management dialog box appeare. 

2 - ZfXSiSSlS^ C ° mPUter ManaSCment *** «P- ^rvices and Applications, 
The list of services appears in the right-hand pane of the Computer Management dialog box. 

4 !w! i liC ^r Plnetd in right-hand pane and choose Stop. 

Set fig ^ P ° mt t0 Pr08ramS ' Uni ^ S » A PP ,ication A ^t Manger, and then choose 

/. CJaoose OK. 

Your password is changed. 

tSotSTc^^^ 

Changing Your OsmosGriffin Password 

Perform the following steps to change your OsmosGriffin Password: 

1 • Right click My Computer and select Manage from the shortcut menu. 
The Computer Management dialog box appears. 

2 ' S!*£!5£l£^ COmPUter Mana8emCDt dia, °* b ° X > a-*- and Applications, 

The list of services appears in the right-hand pane of the Computer Management dialog box. 
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3. Right click OsmosGriffin service in the right-hand pane and choose Stop 

4. After the service stops, right click the OsmosGriffin service and choose Properties. 

The OsmosGriffin Service Properties dialog box appears. 

5. Select the Log On tab in the OsmosGriffin Service Properties dialog box 
o. type the new password twice and choose OK 

7. Inthe Computer Management dialog box, right click the OsmosGriffin service again and choose 

8. Close the Computer Management dialog box. 

New Features: !C 4 

Analysis 

• The analysis database has been restructured to significantly enhance performance of 
the Common Process and Associated Dependencies report. 

• Revised column ordering in five reports now removes inconsistencies in the 
presentatton of the result sets, making the analyses easier to understand and to share 

D fferlnme^ 38 ***** A PP^ns, Different Processes, and 

Different Dependencies, now share a common results format. 

• Filter options for the Common Process and Associated Dependencies report have 
been relabeled to remove ambiguity about whether they apply to the process or to its 
dependencies. The labels now clearly state that the filters apply to dependencies 

New Features: IC 3 
General 

• SlS? 1 ^ ? i ? V f ery ' A ?^ lysis Database Load «. Analysis now use a temporary 

w a °L a WOrla °, S P3th When movin S data be tween the file system and the 
Application Asset Manager database. You are no longer required to set a working 

Pa* when you create a project. The temporary directory is deleted when each 

E£a " ?"? a Y °\f n W the ° pti ° n ° f Usin S a woridn 8 P a * if yon wish. 
See the Application Asset Manager Help file for details. 

• slw 60 * 8 Sp ^ ciah * z ?i for server consolidation through a single, high-level 
setting - the Server Consolidation Tools option under the AAM I Options menu 
Application Asset Manager folders are specialized for server consolidation in the 
same manner. 

The term "Server Consolidation Project" has been removed from the File | New menu 

SJJT f J W i C ° nteXt mCnU in ** ■W**"* P 3 ^ of Windows Explorer. See the ' 
Help file for details on creating projects and folders for server consolidation 
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Discovery 

• The process discovery agent sends a heartbeat to the consultant's notebook computer 
irrformmgpsexec.exe that all is well. If PsExec does not detect a heartbeat for a 
period of 60 seconds, it terminates the agent and logs an error message. 

• If the network connection to the remote host is lost and the discovery operation 
cannot be terminated normally, the service on the remote host terminates itself 30 
seconds after the process discovery agent is terminated. See New Features- IC 2 
below, for a description of process discovery agent self-termination. 

' Ie^A T fr!rl S Lni CeS 18 ? ° D 3 rem0te host ' disco ve *y ski P s ««ver and proceeds to the 
next. A log entry tells you why the server was bypassed. 

• Discovery XML files are now verified for completeness. Both successful and unsuccessful verification 
results are sent to the log. Discovery files that fail the validation test are deleted vacation 

• Discovery log error messages have been upgraded. They are now more complete and informative. 

Analysis 

• The Common Processes and Associated Dependencies report has been modified to be 
more simple and efficient. Rather than querying all dependencies on all processes, the 
report now queries all dependencies on a single process. Because you are required to 
enter the process name when you run the report, you should first run the Common ' 
Processes report to generate a list of process names. 

• Listallation of IC 3 does not require you to rediscover systems previously discovered. 
However, discovery data (XML files) from previous versions of Application Asset 
Manager must be reloaded into the analysis database. When you reload the 
analysis database, the old database is backed up as <AAM installation 
directoiy>\AAM^bs\Analysis.mdb.old, and a new IC 3 analysis database is created 

SSTS 0 ? y ™2T age ab ° Ut the database chan S e is re P° rted on scre *n and posted 
to the file IoadXML.log. 

New Features: IC 2 

Discovery ' 

• The process discovery agent will now timeout and remove itself from the remote 
system after 30 minutes. Typically, the discovery agent will complete its task and 
remove itself m less than five minutes. However, there have been instances where the 
process discovery agent looped due to network errors. The timeout ensures that the 
process discovery agent will not persist on the remote system under any 
circumstances. 
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Discovery 



The process discovery agent sends a heartbeat to the consultant's notebook computer 
informing psexec.exe that all is well. If PsExec does not detect a heartbeat for a 
period of 60 seconds, it terminates the agent and logs an error message. 



• If the network connection to the remote host is lost and the discovery operation 
cannot be terminated normally, the service on the remote host terminates itself 30 
seconds after the process discovery agent is terminated. See New Features: IC 2, 
below, for a description of process discovery agent self-termination. 

• If NT Terminal Services is detected on a remote host, discovery skips that server and proceeds to the 
next A log entry tells you why the server was bypassed. 

• Discovery XML files are now verified for completeness. Both successful and unsuccessful verification 
results are sent to the log. Discovery files that fail the validation test are deleted. 

• Discovery log error messages have been upgraded. They are now more complete and informative. 

Analysis 

• The Common Processes and Associated Dependencies report has been modified to be 
more simple and efficient. Rather than querying all dependencies on all processes, the 
report now queries all dependencies on a single process. Because you are required to 
enter the process name when you run the report, you should first run the Common 
Processes report to generate a list of process names. 

• installation of IC 3 does not require you to rediscover systems previously discovered 
However, discovery data (XML files) from previous versions of Application Asset 
Manager must be reloaded into the analysis database. When you reload the 
analysis database, the old database is backed up as <AAM installation 
directory>\AAM\Dbs\Analysis.mdb.old, and anew IC 3 analysis database is created 
automatically. A message about the database change is reported on screen and posted 
to the file loadXMLJog. 



New Features: IC 2 
Discovery 

• The process discovery agent will now timeout and remove itself from the remote 
system after 30 minutes. Typically, the discovery agent will complete its task and 
remove itself in less than five minutes. However, there have been instances where the 
process discovery agent looped due to network errors. The timeout ensures that the 
process discovery agent will not persist on the remote system under any ° 
circumstances. " 6 
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Analysis 



• New more efficient SQL queries have been implemented in order to reduce query 
complexity and to improve query performance when analyzing a large number of 
systems. 

Installation of IC 2 does not require you to rediscover systems previously discovered 
dafcbttT PreV1 ° USly discovered data (XML files) must be reloaded into the analysis ' 

Fixed Problems 

• Choosing the Cancel button during discovery does not terminate the discovery 
operation. 3 

Resolution: The Cancel button now terminates the remote process and the discovery 
operation stops. A log entry cites the reason for the user-initiated termination. 

• Analysis compares dependencies using timestamps instead of version strings, even 
though Same Versions" or "Different Versions" was selected in the Analysis window. 

Resolution: New buttons have been added to the Analysis window so that users can 
specify whether to compare dependencies by timestamps or version strings. 

• Discovering servers more than once causes an Access Denied error. 

Resolution: The default options for deployment and discovery no longer change the 
attributes of the files written to or read from the working path to read only. 

• Loading or analyzing a discovery file contained in a project or folder whose name contains an 
apostrophe causes a run-time error. 

Resolution: Apostrophes can now be used in project or folder names. 

• Simultaneous discovery of a single host leaves the service psexesvc.exe executable installed and 
running on the remote host. 

Resolution: The service is now removed automatically when the discovery has been 
completed. If the service is ever left behind, it can be removed manually from a 
command window by using the following commands: 

psexesvc -remove 

del psexesvc.exe 

• Choosing the Differences button on the Checkin dialog box causes a run-time error. 
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Resolution: The differences are now calculated and displayed correctly. 

' Configuring Ae Application Asset Manager on a computer that has an FTP service instaUed other than 
Microsoft Wmdows Internet Information Services (US) and Microsoft Windows File Wfer Protocol 
(FTP) server causes a wannng message during the configuration that claims FTP is noSaUed 

ResolutiomThe warning message is now changed to indicate that Windows IIS and 
Windows FTP server are required on an Application Asset Manager server if the 
database is to be accessed from a remote client computer. 

► When a CS V file is modified in the Discovery Wizard by removing one or more host 
list entries, the change is not saved to file. 

Resolution: Changes due to removal of listed hosts are now saved to file. 

When attempting to analyze more than about 20 files, the Analysis Manager fails to 
open, giving the error: "Expression too complex in query expression." 

Resolution: You can now analyze all files in the analysis database. 

Loading or analyzing a large number of discovery files may cause a runtime error. 

Resolution: Databases created after IC 2 is installed are able to load as many files as 
will fit into the database. For databases created prior to IC 2, please see the 
workaround for the last item in the Known Problems list, below. 

Captured discovery files fail to load into the analysis database if they were previously 
loaded into the analysis database and then either renamed or copied to another name 
in another folder in the Application Asset Manager database. 

Resolution: In the Application Asset Manager database you can now copy discovery . 
files to another project or rename them, and then load them successfully into the . 
analysis database. 

Analyzing a discovery file contained in a project whose name contains a space-causes 
a run-time error. 

Resolution: You can now analyze files within projects whose names contain spaces. 

hi the Discovery Wizard Advanced Discovery Options dialog box, choosing the 
Options button again while a Discovery Options (Process Discovery) dialog box is 
already displayed causes the Explorer to enter an infinite loop. 

Resolution: You can now choose the Options button while the Discovery Options 
dialog box is open without causing a problem. 
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• Li the Analysis Manager, the Common Process and Associated Dependencies report 
returns incorrect results. 

Resolution: The Common Process and Associated Dependencies report now returns 
correct results. 

Known Problems 

The following are known problems with the Application Asset Manager 1.1: 

• When a container is selected m the left pane of Explorer and that container has the same name as the 
currently selected container, the right pane of Explorer is not refreshed. 

Workaround: Select a container with a different name in the left pane and then 
select the desired container. 

• When Analysis starts, the window is too small to show all of the controls. 

Workaround: Manually resize or maximize the Analysis window. If this does not 
work, change your screen resolution to 1024 x 768 with small fonts. 

• The first column in the Results tab in the Analysis window can be edited. 

Workaround: Select the Reports tab and choose Query. Return to the Results tab and 
the results will be refreshed. 

• Discovery does not run on a virtual SQL server. 
Workaround: None. 

• Loading or analyzing a large number of discovery files may cause a runtime error. 

Workaround: To fix this problem complete the steps below on each project where 
the runtime error occurs. 

1) Select the project in either the left- or right-hand pane of Windows Explorer. 

2) Right click and select Server Consolidation Tools, Analysis Database Loader 
and Advanced Properties from the popup menus. * ' 

The Properties dialog appears with the Deployment tab on top. 

3) Select Load in the list control labeled "Execution Sequence for Analysis 
Database Loader". 

4) Choose "Edit". 

The Edit Application dialog appears. 

5) .u D ?f/ e * S *! Xt in the edit box Iabeled "Parameters" and replace it with the text 
on the following line: 
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-f"_loadFilePath_" 

Note: There is a blank character after M -f 1 and two underscore ("J 1 ) characters 
before and after "loadFilePath". 

6) Choose OK on the Edit Application dialog box. 

7) Choose OK on the Properties dialog box. 

The Analysis Database Loader can now be used to load a large number of 
discovery files. 

Note: To fix the same problem for Analysis perform steps 1-7 again but replace 
Analysis Database Loader in steps 2 and 3 with Process Analysis. 

Release and Support Policy 

Release Policy 

The Application Asset Manager software is for use by Unisys personnel oniy, and is not intended for 
licensing to a customer at this time. Unisys personnel should not leave this software with customers under 
any conditions. 

Support for Unisys Software Products 

Unisys Engineering (Pacific Development Laboratory in Mission Viejo, CA) fully supports the Application 
Asset Manager software as if it were a major release. Users are to submit any problem reports, called User 
Communication Forms (UCFs), against the release, which is registered with Unisys Product Support 
system, identifier AAM. 

Problem reports can be submitted through the Unisys Customer Support Centre (CSC). 

Obtaining Fixes 

Fixes to the software are available on the SystemFlow Web site in the form of Interim Corrections (ICs). 
An IC is a replacement module or modules that contain fixes for portions of a product or the replacement of 
an entire product. 

By downloading any version of Application Asset Manager or an IC from SystemFlow, users are placed on 
a mailing list so they can be notified whenever a new IC is available 

Application Asset Manager - Workflow 

Overview of the Workflow for Server 
Consolidation 

The workflow for server consolidation using the Application Asset Manager begins with the discovery 
process, which you perform once you are at a customer site* There are a number of tasks you must perform 
before beginning the discovery process. These tasks are as follows: 
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you can use 
in the 



• Venfy that your notebook computer meets the installation requirements 

• Download and install the Application Asset Manager. 

• Run the Configuration wizard . 

Application Asset Manager Explorer Shell 

Because the AppUcation Asset Manager is integrated with the Microsoft Windows Explorer you 
a .^!° rer * w C t0 bTOWSe and ovulate objects such as projects, folders and files stored m tne 
Appl.cat.on Asset Manager database. This interface enables you to manage your project ^ configuration and 
file archrves, and to revxew archive history, revert to earlier versions, and > deVelojl Jprojecfc coSendy 

° n ,^ SSet Ma ?, ager , EXP l°^ Pteseats 3 hierarcl, y of objects in a tree view and a corresponding 
fast of objects in toe currently selected folder. You perform various operations such as discovery and 
analyse on the objects through the Server Consolidation Tools menu or through context menus 

Opening Application Asset Manager Explorer 

To open the Application Asset Manager Explorer, double-click the Application Asset Manager icon on 
£n ExSer OT ™" MDU '** *"* ProgramS > "nisys. Application AsSSge" nd 

You can also right-mouse click the Application Asset Manager icon on your desktop and select.Explore 

Connecting to the Application Asset Manager 
Database 

M^Zr^ ^ w diS , C ° VC ^ d analySis tools ' y° u mnst first connect to » Application Asset 
s^s^ent! m md ° WS EX ? ,0rer ° r l0g in t0 a database ** has becn comteZd previously. In 
foHoXg ltep7 10nS ' "** S,mP y 8 ^ t0 th3t databaSe - T ° COnnect to a database * P erfonn *• 

J' ? f* * x P ,orer ^ndow, right-click Application Asset Manager in the left-hand pane. 

m CCt a 3 Datab ! S 6 ' Ma entet * e hoSt name of * e macbjne ' the datebas * na»e, and 
your user ID and password. 

Note: The user ID and password must be the same as the ones you entered in the Configuration wizard. 

3. At the bottom of the Connect to a Database dialog box, there are two checkboxes: Remember 
Password, wh.ch saves your user ID and password, and Auto Login, which automatically logs you • 

4. Choose QKL password su PP lied and ™ U dialog box in future sessions. 

To login to a connected database, perform the following steps: 

1 * Se1e 5 ft E hrnd r pan V e ndOW ' risht " Click 3 database Hsted under *» Application Asset Manager icon in 
2 " f 0 gfn * L ° 8in ' * e L0Si " dia, ° 8 b ° X appearS if Auto Login was not seJected durin S a Previous 
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Sb^tt^aSy!^ ^ CO,UleCt t0 4 031313356 dial ° 8 bOX ' 6XCept ^ Ae h0St name «* 

3. Enter your user ID and password as required. If you selected the Remember Password checkbox 
when you connected to the database initially, you should not have to enter any Sformatio* 

Note: The user ID and password must be the same as the ones you entered in the Configuration wizard. 

4. At the bottom ofthe Login dialog box, there are two checkboxes: Remember Password which 
saves your user ID and password, and Auto Login, which automatically logs you in wS your user 
ID and password supplied and will skip this dialog box in future sessions 

5. Choose OK. 

Creating a Project 

tSS^^^SSt 0 Manager database * ^ must configure * e shellb * 



menu. 



is 

a 



1. In the Explorer window, select the database, and choose Options from the AAM 
The Application Asset Manager Options dialog box appears. 

2. Select the General tab. 

3. Select Server Consolidation Tools from the Tools Menu list. 
The Server Consolidation Tools menu item is added to the menu bar. 

Next you need to create a container to manage your discovered assets. This container 
called a project. A single project might be sufficient for your discovery operation at a 
customer site. However, if the customer site is complex, you might want to create several 
severt wa^ * ^ Application Manager- You can create a project 

1 . You can use the Explorer menu bar to create a new project 

Select File, New, and then select Project. A new project folder appears in the right-hand pane. 

2. Type a name for the project (for example, XYZBank) and press Enter. 

You can also create a project by selecting the database in the left-hand pane and right 
clicking m the right-hand pane. ^ 

1 . Select New, and then select Project. 

2. Type a name for the project (for example, XYZBank) and press Enter. 

Discovery 
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Discovery is the first stage in server consolidation using the Application Asset Manager. You must obtain a 
list of the systems you want to include as part of the discovery process, and have the customer provide an 
adrninistrator user ID and password for those systems. Administrator privileges must include the right to: 

• Debug programs 

• Load and unload device drivers 

In addition, each target server must have both the ADMINS share and the IPCS share enabled. 

Once you have this list of servers and access privileges, you can initiate the discovery process on those 
servers. 

Note: Discovered systems can be any type of Windows 2000 server or NT 4.0, 
SP6 server. However, while Windows 2000 Terminal Server is supported, NT 
Terminal Server is not supported for discovery at this time. 

Using the Discovery Wizard 

The discovery wizard provides a graphical interface for configuring and running the discovery operation on 
remote servers and systems. It provides all of the required choices, including designating the target 
discovery systems and scheduling the discovery operation. Although you can configure and run the 
•discovery operation using other methods, the wizard is recommended for all first-time users. 

Selecting the Target Servers for Discovery 

You can discover assets from one or many targeted servers in a single discovery operation. You can also 
choose to perform more than one discovery operation, each one targeting another set of servers. However, 
you must have access rights (as an administrator) to all of the servers targeted for discovery, and each 
server must have the ADMINS share (Remote Admin) and the IPCS share (Remote IPC) set. 

Note: The access rights must include the rights to debug programs and to load and unload device drivers. These 
rights must be part of your rights as an administrator on the targeted servers and you must have both of 
these rights. 

Using the Discovery wizard, the following discovery options are available: 

• Discovery by Host Name 

This option enables you to select a single server for discovery. You must know the name of the host 
machine, and a user name and password with administrator privileges. 

• Discovery by Host List 

This option enables you to select a group of servers from a host list for discovery. If you do not have an 
existing host list, you can create one after you select this option. You must enter a user name and password 
with administrator privileges for each server in the list. The host list takes the form of a CSV (comma- 
separated values) file. 
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• AJo£: In a CSV file, any exotic characters (spaces or tabs) that exist between commas or 
at the end of a line are included as part of the string for that field. A password with an 
appended space character may not work as expected. The last field (password) can 

SESSHf " y be terminated with a comma character to explicitly delimit the fieldJDiscovery by 
TCP/IP Subnet J J 

This option enables you to select all servers within a specific TCP/IP subnet You must enter the network 
subnet address and a user name and password with administrator privileges for all systems in the subnet. 

■ Discovery by Site Name 

This option enables you to select all servers in a specific site. You must enter the site name and a user name 
and password with administrator privileges for ail systems within the site. 

• Discovery by Domain Name 

This option enables you to select all servers in a domain. You must enter the domain name and a user name 
and password with administrator privileges for all systems within the domain. 

After selecting one of the preceding options and providing the required information, you must save your 
settings. You can now run the discovery operation from the Advanced Discovery Options page in the 
wizard or run discovery from the Discover dialog box. 

You can set additional discovery parameters before running the discovery operation. For example, you can 
change the default values in the Properties dialog box and the Discovery Options dialog box, and schedule 
. .the discovery task. Refer to the Application Asset Manager online help for instructions on how to perform 
any of these tasks. - 

Running the Discovery Operation 

You can run Discovery by choosing the Run button from the final screen of the Discovery wizard. You can 
also run the discovery operation by performing the following steps: 

1. Click Server Consolidation Tools in the menu bar. 

2. Select Process Discovery from the dropdown menu and then select Discover. The Discover dialog 
box appears, allowing you to run the discovery operation. 

Process Discovery: Technical Details 

Note: The following information is Unisys Confidential. It must not be shared 
with clients under any . circumstances. 

Before you can run process discovery, you must configure it on your notebook computer 
using the Discovery Wizard or the Server Consolidation Project Properties dialog box. 
You can then launch discovery by choosing Run in the Wizard or choosing OK in the 
Discover dialog box. See the Application Asset Manager Help for details on configuring 
and launching discovery. 

When you launch discovery, you run psexec.exe, a program that executes processes on remote systems 
without requiring you to install client software on those systems. When you configure discovery using the 
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Discovery Wizard and then look at the discovery properties, you can see the PsExec parameters. These 
parameters vary depending on the discovery scenario that you define, such as discovery of a single host, 
discovery using a host list, and discovery of all systems in a domain. The final argument in the parameter 
list is always the name of the agent or process that is run remotely. In this case, the agent is called 
procDiscovery, or process discovery. 

PsExec and procDiscovery work together to perform discovery of appUcations, processes, process 
dependencies, and other information on remote systems as follows: 

1. PsExec copies a service, psexesvc.exe* to the $ ADMIN share of the remote host, where it runs 
under the local system account. 

2. PsexeSvc then opens a named pipe and waits for incoming calls; 

3. PsExec connects to PsexeSvc and opens three additional named pipes 

4. PsexeSvc connects to the three named pipes, to which it redirects stdin, stdout, and stderr for 
procDiscovery. 

5. PsexeSvc then creates a process for procDiscovery and waits for it to finish. 

The ProcDiscovery agent is copied from the notebook computer to the remote host, where it 
resides temporarily on the $ ADMIN share. ProcDiscovery uses a device driver to capture 
information about running processes. The system creates a legacy registry key that is not under the 
control of procDisco very. 

ProcDiscovery impacts the host system only minimally - about two to 10 seconds of processor 
time and about 10 MB of memory usage while it captures information. 

6. ProcDiscovery places its device driver in memory on the remote host. 

ProcDiscovery makes a registry entry on the remote host only long enough to launch its device 
driver. The registry key is deleted as soon as the device driver is launched. 

7. ProcDiscovery captures information from the host as specified in the discovery model. 

8. ProcDiscovery writes the captured information to stdout, from which it is passed by PsExec to a 
local file on your notebook computer through the dedicated named pipe. 

9. ProcDiscovery writes its errors to stderr. PsExec reads from stderr and writes to the display and to 
the log (PsExec<date>.Iog). 

10. ProcDiscovery removes its device driver from host memory. 

11. ProcDiscovery goes to normal end of job, and then reports "success" to PsExec. 

12. PsExec and PsexeSvc close the named pipes. 

13. PsExec stops the service through the $IPC remote share. 

14. PsExec removes procdiscovery.exe and psexesvc.exe from the $ADMIN\system32 directory. 

The only trace remaining on the remote host is the procDiscovery registry key created by the host 
(HKLMXsystemKCurrentControiSetXEnumNRootXLEGACY^PROCEXP). This key might also 
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appear in the ControlSetXXX key tree. 

• If procDiscovery does not reach the normal end of job after 30 minutes, 
the failsafe timer terminates the agent using a C "_exit" call. PsexeSvc 
times out 30 seconds later and PsExec attempts to clean up normally. In 
this case, one additional trace is left on the host system: 

The procDiscovery device driver, only 6Kbytes in size, remains in 
memory and is inaccessible. It has no effect on subsequent discovery 
attempts. The device driver is removed from memory the next time the 
system is restarted. 

If PsExec terminates the process discovery agent abnormally, the net results are the same 
as when the agent is terminated by the failsafe timer. 

Process Discovery Datapoints 

The following table lists the complete set of datapoints collected through the discovery 
operation. While most datapoints reference features of the target system, some are 
internal to discovery itself. An example of the latter is the fiist datapoint - Unique file 
identifier. Symbols with no data type or sample data entry (grey field) represent 
organizing schema for the XML file. They are the classes of the Discovery Model. 



Note: This table is Unisys Confidential. It must not be shared with clients under 
any circumstances. 



Data Type 


Symbol 


Sample Data 


Description 




PE_SysInfo 




Information about the host 
operating system 


Unique file identifier 


PE__Sy s I nf o_I D 


2816CLAN3708-SI 


Unique identifier for the PE_Syslnfo 
XML element. A (statistically) 
unique identifier for the file itself. 


Version of AAM Process 
Discovery 


PE_SysInfo__discoverV 
ersion 


1-1.2 


Version of procDiscovery used to 
gather this information. 


System name . 


PE_Sy s I nf o_ sy s temNam 
e 


USMV-SYS14TTP 


Name of the discovered host 
system. 


Operating system major 
version number 


PE_Sy s I n f o_psMa j orVe 
rsion 


5 


Operating system major version 
number. 


Operating system minor 
version number 


PE_Sys Inf o_osMinorVe 
rsion 


0 


Operating system minor version ■' 
number. 


Operating system build 
number 


PE__Sy s Inf o_os Bu i 1 d 


2195 


Operating system build number. 


Operating system 
revision number 


PE__Sy s Inf o_os Re v 




Operating system revision number. 


System page size 


PE_jSysInfo_jpageSize 


4096 


Page size and the granularity of 
oaae Drotection and commitment, in 
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bytes. 


System allocation 
granularity 


PE_SysInfo_allocatio 
nGranularity 


65536 


Granularity with which virtual 
memory is allocated, in bytes. 


System total memory 


PE_SysInfo_totalMemo 
ry 


267964416 


Total size of physical memory, in 
bytes. 


System available 
memory 


PE_SysInfo_available 

i v itiin(Jiy 


188866560 


Size of physical memory available, 
in bytes. 


System total virtual 
memory 


PE_SysInfo__totalVirt 
ualMemory 


2147352576 


Total size of the user mode portion 
of the virtual address space of the 
calling process, in bytes. 


System available virtual 
memory 


PE_Sy s inf o_avai 1 abl e 
Virt ualMemory 


2147352576 


Size of unreserved and 
uncommitted memory in the user 
mode portion of the virtual address 
space of the calling process, in 
bytes. 


System total page file 


PE Syslnfo totalPage 
File 


1032663040 


Total possible size, in bytes, of the 
paging file. Note that this number 
does not represent the actual 
physical size of the paging file on 
disk. 


System available page 
file 


PE_SysInfo_available 
PageFile 


853843968 


Size of space available in the 
paging file, in bytes. 


System memory load 


PE Syslnfo memoryLoa 
d 


29 


NT 4.0: The percentage of 
approximately the last 1000 pages 
ui pnysicai memory in use. 
Windows 2000: The approximate 
percentage of total physical 
memory in use. 




PE— SysInfoEx 




Additional information about the 
host operating system for Windows 
versions later than NT 4.0. 


Element identifier 


PE_SysInfoEx_ID 


EX 


XML identifier of this element. . 


Operating system major 
service pack 


PE_Sys Inf oEx_s ervi ce 
PackMa j or 


•0 


Major service pack number for the 
host operating system. 


Operating system minor 
service pack 


PEj3ysInfoEx_service 
PackMinor 


0 


Minor service pack number for the 
host operating system. 


System type 


PEjSysInf oEx_product 
Type 


PROD— SERVER 


Type of Windows 2000 system 
installed: 

PROD_WORKSTATlON: Windows 
2000 Professional 
PROD_DOMAIN_CONTROLLER: 
Used as a domain controller 
PROD_SERVER: One of the 
Windows 2000 server versions (see 
InstPkg) 




PE_InstPkg 




Packages included with this type of 
Windows 2000. 


Element identifier 


PE_InstPkg_ID 


IP-4 


XML identifier of this element. 
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.»03dL9t 



Package name 


PE_Ins t Pkg_value 

• 


PKG_TERMINAL 


The name of one of the included 
packages. One or more of the 
following can be installed: 
PKG_SMALLBUSINESS: Windows 
Small Business Server. 
PKG_ADVANCED_SERVER: 
Windows Advanced Server. 
PKG_BACKOFFICE: Microsoft 
BackOffice components. 
PKG_COMMUNICAT!ONS: Windows 
Communications Server. 
PKGJTERMINAL: Terminal Services. 
PKG_SMALLBUSINESS_RESTRICTE 
v. iviicrosori omau Business oerver. 
Restrictive client license in force. 
PKG_EMBEDDEDNT: (Unknown) 
PKG DATACENTER: Windows 2000 
DataCenter Server. 
PKG_SINGLEUSERTS: Single-user 
terminal services. 
PKG PERSONAL: Windows version 
is Personal edition, not Professional 
PKG_BLADE: Blade server package. 




PEJHdwelnfo 




Information about the processors, 
devices and drives of the host 
system. 


Element identifier 


PE_HdweInfo_ID 


HI 


XML identifier of this element. 


Number of processors 


PE_HdweInf o_numberOf 
Processors 


1 


Total number of processors on the 
host system. 


Available processor 
mask 


PE__Hdwe Inf o__ava i labl 
eProcessorMask 


1 


Specifies a mask representing the 
set of processors configured into 
the system. Bit 0 is processor 0; bit 
31 is processor 31. 


Processor level 


PE_HdweInf o_ processo 
r Level 1 


6 


Processor model (Intel only): 

3 - 80386 

4 — 80485 

5 — Pentium 

6 — Pentium Pro or Pentium II 


Processor revision 


PE_HdweIn£ ojorocesso 
rRevision 


1282 


Revision number of the processor. 




PE__De vi c e 




Information about devices on the 
host system PCI bus. 


HowifQ noma 

Device name 


PE_JDe vi c e de vi c eName 


Matrox Graphics 
Millennium G200 


Name or tne device. 


Device location 


PE_Device_ deviceLoca 
tion 




Location of the device. 


Device CMP location 


PE_De vi ce_ctnpLoca t i o 
n 


0,1,0,1 


Meaningful only on ES7000 
systems: the ES7000 bus address 
of the device. 




PE_Drive 




Information about the non-network 
disc drives on the host system. 


Element identifier 


PE_Drive_ID 


DR_C 


XML identifier of this element. 
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Drive letter 


PE Drive driveLetter 


C 


Logical drive letter of the drive. 


Drive volume name 


PE_Drive_yolumeNan\e 




Volume name of the drive, if any. 


Drive serial number 


PE Drive_serialNumbe 
r 


753143928 


Serial number of the drive. 


Maximum filename size 


PE_Dr ive_jmaxFi 1 eMame 
Size 


255 


Maximum filename size for the 
onve, in Dyies. 


Fi!e system type 


PE__Dr i ve_f i 1 e Sy s t emT 

ype 


NTFS 


Type of file system for the drive. 


Drive total bytes 


PE_Drive_totalBytes . 


9097125888 


Total capacity of the drive, in byt 


Drive free bytes 


PE__Drive_freeBytes 


4877783040 


Available capacity of the drive, ir 
bytes. 




PE_ : DriveFlag • 




The characteristics of a drive. 


Parent element identifier 


PE_DriveFlag_parent_ 
ID 




XML Identifier of the parent 
element. 


Drive flag values 


PE_priveFlag_f lag 

• 


CASE_IS_PRESERVED . 

CASE_SBNSITIVE 

UNICODE_STORED 

PERSISTENT_ACLS 

FILE_COMPRESS ION 

NAMED_STREAMS 

SUPPORTSJENCRYPTI 

ON 

SUPPORTS_OBJECTJI 
DS 

SUPPORTSJREPARSE_ 
POINTS 

SUPPORTS_SPARSE_F 
ItiES 

VOLXJME__QUOTAS 






PE AoDCatalocrl tetn 


7-f?r:'b- '-MP-' JiV?-- '? v-Egf • - ? ■■ £3 


Information about the installed 
applications that appear in the 
AuO/Kemove rTograms usi ot u 
Control Panel. 


Application name 


PE___AppCa t a 1 og 1 1 etn^_ap 
pName 


TTn "i ot/'cs 
LJIXX o j o 

Application Asset 
Manager 


Momg of the aontication 


Application version 


PE_AppCa t a log 1 1 em_ap 
pVersion 


1.1.3 


Version of the application. 




PE_Process 




Information about the active 
processes on uie noai 5>yt>itjni. 


Element identifier 


PE_Proce s s_ID 


Process. 832 


XML identifier of this element. 


Process name 


PE_Pr oces sjpr oce s sNa 
me 


AUDEMON.EXE 


Name of the process. 


Process ID (PID) 


PE_Process_processId 


832 


PID of the process. 


Process depth 


PE_Process_depth 


0 


Nesting level of this process w 
other processes. 


Process affinity mask 


PE_Pr oces s__af f ini tyM 
ask 


1 


Processor mask in which this 
process must run. 
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Process owner 


PE_Process_processOw 
ner 


USMV- 

SYS14TTP\userl 


Owner of the process. 


r'areni eierTioni ludiuifci 


PE Process oairentPiro 
cess ID 




XML Identifier of the parent proce 
element. 


riOCcoS 5>laii units 


PE Process sfcairtTinie 


15:31:08 10 Dec 
2002 


Time when the process was last 
started. 


Process handle count 


PE_P roce s s_handl e Cou 
nt 


113 

l 


Number of open handles. 


Pmne^s base orioritv 


PE Process basePrior 
ity 


13 


Windows priority of the process. 


Pmr^w CPU time 


PE Process cpuTime 


1093750 


Process time in system (100ns) 
ticks. 


Percent process CPU 
time 


PE_Process_jpercentCp 
uTime 


0 


Percentage of CPU time taken 
this process since it started. 


1 Process has services 
(boo!) 


PE_Process_hasServic 
es 


false 


True if this process is a system 
service. 


Process has no owner 
(bool) 


PE_JPr oce s s — ownPr oce s 
s 


false 


True for certain processes that 
have no owner. 


Process peak virtual size 


PE_Process_peakVirtu 

al Oi 7p 


114941952 


Peak virtual memory usage, in 
bytes. 


Process page fault count 


PE_Process jpageFaul t 
Count 


298 


Number of page faults taken by 1 
process. 


Process peak working 
set size 


PE__Process_peakWorki 
ngSetSize 


1232896 


peaK worKing set size or tnis 
process, in bytes. 


Process working set size 


PE_ Process^ workingSe 
tsize 


1232896 


Current working set size of this 
process, in bytes. 


Process peak paged 
pool usage quota 


PE_Process_quotaPeak 
PagedPoolUsage 


114560 


Peak paged file usage charged 
against this process* disk quota, 
bytes. 


Process paged pool 
usage quota 


PE_Process_quotaPage 
dPoolUsage 


114560 


Current paged file usage charge 
against this process' disk quota, 
bytes. 


Process peak non- 
paged pool usage quota 


PE_Process_quotaPeak 
NonPagedPoolUsage 


1928 


PeaK Q(SK usage oiner inan p<ay 
file charged against this process 
disk quota, in bytes. 


Process non-paged pool 
usage quota 


PE_Pr o ce ss_quo t aNonP 
agedPoolUsage 


1928 


Current disk usage other than 
paging file charged against this 
process' disk quota, in bytes. 


Process page file usage 


Phi rrocess pagenxeu 

sage 


434176 


Current page file usage by this 
process, in bytes. 


Process peak page file 
usage 


PE_Process_j>eakPagef 
ileUsage 


434176 


Peak page file usage by this 
process, in bytes. 


Process private page 
count 


PE_Process_j>rivatePa 
geCount 


434176 


Page file usage not shared with 
other process, in bytes. 


Process version 


PE_Process_version 




Version of the process. 


Process description 


PE_Process_descripti 
on 




Description of the process, if 
available. 
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Process command line 

• 


PE_Process_commandLi 
ne 


C : \Unisys\AAM\bin 
\audemon.exe +AAM 
-L -g 


Full process path with command 
line parameters. 




PE_Module 




Information about the active 
modules on the host system. 


Module version 


PE_Module__ version 


1.01.3110.0006 


Version of the module. 


Element identifier 


PE_Module ID 


Module 0 


AiviL laenttTier or tnis element. 


Module base 


PE_Module_base 


4194304 


Memory base address of the 
module. 


Module size 


PE_Module_s i ze 


20480 


Size of the module in bytes. 


Module mapped memory 


PE Module memoryMapp 
ed 


false 


True if the module is a memory- 
mapped file. 


Module creation time 


PE Module PrMhinnTi 

me 


PM 


Time that the module was created. 


Module description 


PE Modu 1 p mnHiil one»o/-» 
* iwuuxc UlUUUXcJUcbC 

ription 




Description of the module, if 
available. 


Module path 


PEJVIodulejpatri 


C : \Unisys\AAM\bin 
\AUDEMON.EXE 


Full path of the module 




PE_ProcessModuleAssn 




Associations between processes 
and the modules on which they 
depend. 


Element identifier of 
associated process • 


PE_ProcessModuleAssn 
_jproc_ID 


Process . 832 


XML ID of the process element 
using a module. 


Element identifier of 
associated module 


PE_ProcessModuleAssn 
module ID 


Module. 0 


XML ID of the module used by a 
process. 



Note: This table is Unisys Confidential. It must not be shared with clients under 
any circumstances. ' 



Application Asset Manager Port Requirements 



The following table lists the known ports on the target server and the network domain 
controller used by the Application Asset Manager during server discovery. 



Port Number/Protocol 


Service Name 


Comment 


Computer System 


139/TCP 


netbios-ssn 


NetBIOS Session Service 


Discovery Target 


445/TCP 


microsoft-ds 


Windows 2000 File Sharing 


Discovery Target 


88/TCP 


kerberos 


Kerberos 


Domain Controller 


389/TCP 


ldap 


Lightweight Directory Access 
Protocol 


Domain Controller 



The following are possible additional ports if the system to discover is running NT 4.0. 



Port Number/Protocol 


Service Name 


Comment 


Computer System 


137/UDP 


netbios-ns 


NetBIOS Name Service 


Discovery Target 


138/UDP 


netbios-dgm 


NetBIOS Datagram 
Service 


Discovery Target 
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Note: men performing discovery with a firewall in the network, it is best to use the 
target system's IP address rather than its hostname. s to use me 

Discovering Servers in a Highly Secure Setting 

At banks and other highly secure client sites the customer may be extremely cautious 
about allowing your notebook computer on their LAN, about allowing remote access to 
production servers, and about distributing user IDs with administrated SSSSfST 
passwords. In such settings, the standard Application Asset Manager approach to 
discovery may not be feasible. In this situation you can try one ofme two client assisted 

St T. bed J? 1 ™ 11151311 *" AppUcati ° n Assef Manager on a clienf 
workstation and tram the customer to configure and run discovery remotely, or perform 
discovery one server at a time directly from each host. ly.orpenorm 

Installing the Application Asset Manager on a Client Workstation 

Important! Do not copy AAMSetup.exe from the CD to the workstation. Run setup from the CD 

2. Work with the customer to configure discovery using the Wizard 

1' 5" n . the * sc f ver y operation as needed to capture client server information. 

4. Conduct analysis on the client workstation. 



OR 



5. 



6. Important! Be sure to uninstall the Application Asset Manager from the client workstation as 
SlL^ 

Performing Discovery Directly on a Host System 

2. Ask the customer to mount the disk on the server, and after navigating to the A drive in the 
Command Prompt, enter the following from the command line: g o me a drive in the 

procdiscovery >A:\<server name>.xml 

Important! Do not allow the customer to copy procDiscovery.exe from the 
floppy d.sk onto the server. This is a violation of Unisys copyrights. 

If the generated XML file is less than approximately 1.35Mb, the floppy disk 
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should now contain all the information that you would normally collect from the 
discovery operation. 

It is important that the file name be the name of the server. Otherwise, you will 
have difficulty managing the generated XML files from the server farm both on 
floppy disk and in the Application Asset Manager database. 

3. Verify that the discovery XML file is complete. 

To verify that the file is complete, open it and confirm that the last line contains 
"</dataroot>'\ If the file is complete, go to step 6. If the file is incomplete, go to 
step 4. 

4. Ask the customer to mount the disk on the server and enter the following from the command line: 
procdiscovery xhard drive letter>:\<server namO.xml 

Important! Do not allow the customer to copy procDiscovery.exe from the floppy disk onto the 
server. This is a violation of Unisys copyrights. 

5. Ask the customer to copy the generated XML file to a server that you can access from your 
notebook computer. 



6. Copy or drag the <server name>.xml file to the Application Asset Manager database on your 
notebook computer and proceed with the analysis stage of application profiling. 

Analysis 

Analysis is the second stage in server consolidation. The analysis process enables you to evaluate the 
results from the discovery operation with the aim of revealing potential consolidation candidates and 
possible consolidation conflicts. You can generate reports to identify common processes and files, and any 
differences in the processes and process dependencies across the server analysis group. 

Loading the Discovery Files for Analysis 

Before you can perform analysis, you must load your discovery files into an analysis database. To load 
your files and define the load parameters, select Server Consolidation Tools from the Explorer menu and 
then select Analysis Database Loader and Populate Analysis Database. 

You can also load your discovery files by perfonning the following steps: 

1 . Select your project or folder in the left pane of the Explorer window and do one 
of the following: 

a. Right click the project or folder, select Server Consolidation Tools and 
then select Analysis Database Loader and Populate Analysis Database. 

b. Select Analysis Database Loader and Populate Analysis Database under the Server 
Consolidation Tools menu bar item. 
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discove^fitef 6 AppUcati0n AsS6t Mana e« onIi ne help for detailed instructionson loading your 

Analyzing the Discovered Files 

Once you have loaded your files, you can begin the analysis process. Select a project or folder for analysis. 

1. Perform one of the following steps to run the Analysis task: 

• To analyze the latest revision of all of the discovery files, from the Server Consolidation 
Tools menu point to Process Analysis and then choose Analyze. 

* 1° SS* °f, the fdeS in &e d «ignated Project, select those files in the list using 
die Shift or Control keys. Then point to Process Analysis in the Server Consolidation 

I ools menu and choose Analyze. 

You can also perform the operations above by right clicking the selected project or files 
and selecting Server Consolidation Tools, Process Analysis, and then Analyze from the 
context menu. 



• To analyze the revisions of a single discovery file, right click the file and select Show 
History. The History dialog box appears. Select the revisions you want to analyze and 
then choose Analyze from the Server Consolidation Tools menu in the History dialog box. 

2. The Analysis Manager appears. Select one of the following tabs: 

• Application Statistics 

• Server Statistics 

• Reports 

Generating Statistics 

You can generate statistics by performing the query in the Application Statistics tab. Performing this query 
tells you how many of the applications, processes, and dependencies are the same or are different 
teoughout the server form. When more of these components are common than different, you know 
SJS ^ * g SCrVer consoudation opportunity for the servers curremly selected for 

Z?u S^r 11 8eDera - C Sta ? StiCS ° y P erformin g the ^ery in the Server Statistics tab. Performing this query 
5?JS£?3?T ° f K SyStemS f Server ferm according to the number of processors pe? server, and 
of systems by operating system type. If there is a large number of servers running fewer than 
eight Processors the customer has an excellent opportunity to scale up to a larger server during 

c C o"o^ 



Creating Reports 

I^T^Tf ended J CS iL se 7 er consolidation process involves analysis using reports. The Reports tab in 
Analysis Manager has the following Application Analysis reports that you can select: 

• Common Applications/Processes/Dependencies 

• Common Processes and Associated Dependencies 

• All Applications ° 

• All Processes 

• Different Applications/Processes/Dependencies 
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• Distinct Applications/Processes/Dependencies 

The first two reports, Common Applications/Processes/Dependencies and Common Processes and 
Associated Dependencies, can be filtered by Same Versions or Different Versions. The Common 
Dependencies report and the Common Processes and Associated Dependencies report can be filtered also 
by Same Dependency Timestamp and Different Dependency Timestamp. 

In addition, three reports are related to Hardware.and Operating System Analysis: 

• Processor 

• Operating System 

• Devices 

The Common Processes report and the Common Processes and Associated Dependencies report map 
directly into the System Flow procedure for server consolidation: 

• Determine common application components by server to identify consolidation candidates. 

• Determine dependency variations among grouped consolidation candidates to reveal potential 
consolidation conflicts. 

Select the report type to run a query. When the query is completed, the. results are displayed in the Results 
tab. You can sort the results on any of the available columns. If you need to clarify the results, you can 
refine your query and run it again. 

All queries are viewable if you check the Display as an SQL Query box in the Reports 
tab. You can customize a query, and if you want to save it for future reference, copy and 
paste it into a text file. You can reuse the query at any time by selecting Open SQL Query 
Template under the File menu. 

Using the Common Processes Report 

When you select the Common Processes report, all processes running on two or more servers are listed. 
Processes running on only one server are not reported. 

Processes common to multiple servers represent potential server consolidation candidates. However, the 
processes identified across systems might not be identical. For example, several different releases of a 
process might exist across many servers, or the dependencies might be different from one version of the 
process to another. The Common Processes and Associated Dependencies report addresses these 
discrepancies. 

Using the Common Processes and Associated 
Dependencies Report 

This report lists the dependencies associated with a process running on two or more 
servers. You can select a process by first generating the Common Processes report. 
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This analysis report reveals potential problems to consolidation that you can present to 
your customer. Then both you and your customer know those issues to resolve before you 
can begin server consolidation. 

For more information on executing these reports, refer to the Application Asset Manager online help. 

Application Asset Manager - Database 
Administration 

Maintaining the Application Asset Manager 
Database 

It is always good practice to back up your Application Asset Manager database regularly. You can back up 
your database by exporting the current Application Asset Manager database using the Export wizard, and 
then storing the database as your backup copy. The backup copy can be imported into the Application 
Asset Manager provided that you delete the old database and create a new one. 

To access the Export wizard or the Import wizard, from the Start menu point to Programs, Unisys, and then 
Application Asset Manager, and choose Export or Import. 

To delete or create an Application Asset Manager database, from the Start menu point to Programs, Unisys, 
and then Application Asset Manager, and choose Administrative Tools. Refer to the Application Asset 
Manager online help for more information about using these tools. 



Note: If you migrate from one release of the Application Asset Manager to another release, you must 
export your database from the old release and then import it into the new release. 

Maintaining the Analysis Database 

To permit ODBC-compliant queries from the Analysis tool, a separate database is created under the 
AAMXDbs directory. This database, Analysis.mdb, is used for analysis only. The database tables contain 
only data derived from discovery XML files that have been explicitly loaded using the Populate Analysis 
Database menu. The Analysis database contains neither the assets nor the associations between the assets of 
the Application Asset Manager database. 

You might want to archive the Analysis database occasionally. To archive this database, save a copy of the 
file in a different directory. If you lose your database file, you can copy it back into the AAM\Dbs directory. 
You can also reload the Analysis database and a new version of the database file is generated. Saving a 
copy of the file is the recommended method for backing up the Analysis database. 
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Abstract: 

i 

This document is a high-level functional description of the Application Asset Manager (AAM) component 
for the Application Sentinel program, release 1.1. A more detailed functional description will be provided 
in the next draft of this document. 

The AAM will provide the ability to discover running processes, installed applications, hardware 
information, and databases on the target resources managed by a server on which the AAM and other 
Application Sentinel components are installed. Discovery will produce an XML file containing an 
inventory of the information discovered. The AAM will provide the ability to analyze and compare 
inventories to determine opportunities for consolidation or aide in application maintenance and 
^deployment. The AAM will also provide the ability to store application assets in the AAM database and to 
deploy those assets to the target resources as determined necessary from an analysis of the inventories of 
those target resources. 

With a license upgrade a Server Consolidation Plug-in can be enabled in the AAM that will provide the 
ability to discover, analyze, and deploy on Windows servers throughout a network. Inventories can be 
collected by Unisys representatives at a customer site and brought back to the Unisys workplace for 
analysis. The results of this analysis can be presented to the customer in a short period of time as a plan for 
server consolidation. 
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1 . Document Control 

This document was generated using the PPG Template Generator, 3490 3880, revision J. 

1.1. Change History 



Version 



Description 



Initial Revision. 



s 1 .2. Document Cross Reference 

6 None. 

7 2. Introduction 
s 2.1. Purpose 



9 The purpose of this document is to provide a high-level functional description of the new features and 

10 modifications to existing features in the Application Asset Manager (AAM) for the Application Sentinel 

11 1.1 release. 

12 2.2. Scope 

13 Because the AAM is not a new product, it is assumed in this document that readers are familiar with 

14 previous versions of AAM. No attempt will be made in this document to describe all the features of AAM. 

15 ° n *y *ose features that are new or have been substantially modified for the Application Sentinel 1.1 

16 release will be described in this document. 

17 The features and user interfaces described in this document are described in the context of the AAM 

18 Workbench. Although the AAM Workbench is a new user interface, many of the features in the AAM 

19 Workbench are the same as those previously documented in the AAM Windows Explorer shell extension 

20 and will not be 'described in this document. 

21 As a functional design specification this document describes only functional aspects of features and does 

22 not provide information regarding algorithms* data flow, etc. 

23 3. Interdependencies 

24 Application Sentinel Security 

25 Application Sentinel Licensing 
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1 4. Functional Overview 

2 4.1. Major Functions 

3 The major functions provided by the AAM in the Application Sentinel 1 . 1 release are Asset Management 

4 and Server Consolidation. More specifically, Asset Management and Server Consolidation break down into 

5 the functions of discovery, analysis, and deployment. The capabilities included in these functions are 

6 similar for Asset Management and Server Consolidation. The difference is that the capabilities of 

7 discovery, analysis, and deployment in the context of Asset Management are a proper subset of the 

8 - capabilities of these functions in the context of Server Consolidation. 

9 For Asset Management, discovery provides the ability to collect asset inventories from managed partitions. 

10 An * Ivs,s Provides the ability to display and compare inventories to determine commonalities and 

11 differences across the managed partitions. And deployment provides the ability to install software assets 

12 stored in the AAM database on one or more of the managed partitions based on information gleamed from 

13 analysis. 

For Server Consolidati on, discovery provides the ability to collect asset inventories from Windows servers 

J;? on a network. Analysis provides all the capabilities of analysis for Asset Management plus additional 

16 capabilities that aide in determining candidates for consolidation. As in the case of discovery for Server 

17 Consolidation, deployment provides the ability to install software assets on Windows servers anywhere in 

18 the network. 

19 4.2. Assumptions 

J? 11 is assumed that readers of this document are familiar with previous versions of the AAM. No attempt will 

21 be ma de »n this document to describe the full functionality of AAM. r 

?? The discovery and deployment functions included in Asset Management are restricted to the managed 

?T partitions. This document assumes that an interface will be available on the management server to provide 

24 the sel of partitions that are managed by the management server. 

25 5. Functional Description 

26 AAM will provide users the ability to perform Asset Management functions. In AAM these functions are 
Zl discovery, analysis, and deployment. Users can purchase a license upgrade that will enable a Server 

28 Consolidation Plug-in. The plug-in offers all the features of Asset Management plus the ability to discover 

29 and deploy across all Windows servers on a network. The Server Consolidation plug-in also enables some 

30 queries in the analysis tool that will help users determine opportunities for consolidation. 

\\ The remaining topics in this section will provide a high-level overview of the discovery, analysis, and 

32 deployment functions. 

33 5.1. Discovery 

^ Thc A AM discovery function, in its simplest form, can be described as the process of running one or more 
afients on one or more tar S et systems and saving thc information returned by the agents from those targets 

I* In thc AAM database. Two discovery agents will be provided in this AAM release. One is a computer 

37 system discovery agent and the other is a SQL database discovery agent. 

1* The computer system discovery agent returns an inventory of the target system. The inventory returned is a 

~ flle ,n XML form at. The computer system inventory file is saved in the AAM database with the name of 

40 the targe! system and the CSI (Computer System Inventory) file extension. The inventory includes: 
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1 • Hardware information 

2 • OS information 

3 • Installed applications 

4 • Running processes with their DLL dependencies. 

5 The SQL database discovery agent return an inventory of SQL databases running on the target system The 

6 inventory returned is a file in XML format. The SQL database inventory file is saved in the AAM database 
" 7 Wltn the name of target system and the DBI (DataBase Inventory) file extension. The inventory includes: 

8 • SQL Server name and version on the target machine. 

9 • For each instance of the SQL server on target machine, # 
10 o For each database schema 

J * " Collect schema information (tables, views, indexes, roles, etc) 

12 " User logins, permissions and roles 

13 o User objects in the master database 

14 -) ° Database names and logins and database client names 

15 * o SQL configuration settings 

16 o Collation settings 

17 o Jobs and task 

18 o SQL alerts 

19 o Replication 

20 o DTS packages list 

21 o Database size and log size information 

22 5.2. Analysis 

23 The Analysis function can be described as the process for viewing and comparing asset inventories returned 

24 bv the discovery process. The Analysis function provides the following capabilities: 

25 • Application and process differencing 

26 • Hardware and operating system differencing 

27 • Database schema and properties differencing 

28 • Consolidation candidacy determination 

29 • Custom data mining via user-entered SQL statements 

30 • High-level detail view of all discovered assets 

31 5.3. Deployment 

32 The AAM deployment function can be described as the process of installing application assets on one or 
~ more systems. The application assets are stored and versioned in a folder in the AAM database. 

ZZ . Confl S urations are created from the contents of the folder that contain consistent versions of the application 

35 ' assets - Configurations can be deployed to one or more target systems. 

^ Typically an application has a set of requirements that must be met by the target system before the 

application can be successfully deployed on that system. AAM deployment allows the user to create a list 

38 of deployment rules that are checked against an inventory taken from the target system just before the 

3 / application is deployed to the target system. If any deployment rule cannot be satisfied by the target system. 

*Y the user ls n o tif5 ed through a message box and given the opportunity to deploy any way or to cancel the 

41 deployment operation. 

^ An application's assets may consist of one or many files. The AAM deployment function creates a package 

43 that is a self-extracting executable containing all of the files for the application in a compressed format. 

44 This allows all of the application assets to be sent to the target system as a single file which helps to insure 
Zt thal network problems can never leave the deployment in a state where only a portion of the assets ever 
46 reach the target system. 
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The application may have a file that must be executed on the target system to install or configure «*. 

? k rgCt SyS,em - 71,6 AAM de P lo y«« e "t function altows the u ser to sn^ a file iffte 
package thatmust be executed after the application assets have been deployed on The S system S„ce 
the package has been copied to the target system it is executed. The package w! exuXe a™1L? n „ 
S££?T ,tS S ? f ^ 5** th6m to the ^ directory. If the user has specified a Sn^ e to 
execute, the package wtll execute the file and report its success or fai.ureback to the AA^wSoefch 

6. User Interfaces 
6.1. Workbench 
6.1.1. Overview 

ean swtte* back to a pre.tously u«d te„| and working right where Ihey left off. 

Upon exiting the workbench the outran tool and other Information is persisted in the user's reals!™ so that 



25 6.1 .1 .1 .Purpose of Interface 



The AAM Workbench is the user interface that provides access to the AAM Manage Discovery Analysis 

^tZT^T^ a T raon f a T work whi,e a,,owin s -* S to p^Set ralys,s ' 

abm^ ^'S^5 l l ^SS.- B fOT to °'- The W or kbench a.so provides the 



30 6.1.1 .2. Functions 



The Workbench provides a menu bar. The menu bar contains File, Edit, View Tools and Heln menus 

c™ adT" COnta " 1S menU itemS * at « P fesent rc S ardless of wh ich tool i SyS? TheSe tool 
can add new menu .terns to the existing menus or insert new menus in the me™ bar 

mat Z^M OVid&& 3 t0 ° lbar - *"* 1001 POpU,ateS ^ t00,bar with buttons Wriate for 

I^dSta fl^^ ^ l T ti ° n ° ar diSp,ays ,he P ath » f the ««« f older in the 

theuser to ?^ueZ^ ,r **, f ° T ** ,00,S h> and set the loca «o"- This allows 

tne user to cont.nue work.ng in the same location while switching from one tool to another. 

np^^Z^TZ^ E3Ch «"» ^ - ~» oar to show status that is 
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1 The Workbench provides a window for the tools to display their controls in. Each tool can change this 

2 window to display a set of controls that is appropriate for that particular tool. 

3 The Workbench provides a button for each tool to allow users to switch from one tool to another. The 

4 name of the current tool is displayed in the Workbench title bar and the bitmap representing the current tool 

5 is displayed in far right comer of the menu bar. The four tool buttons are adjacent to the left side of the 

6 bitmap. 

7 6.2. Manage Tool 

8 6.2.1. Overview 

9 The Manage tool provides a view into the AAM database folder hierarchy. The Manage tool divides the 

10 Workbench window into three panes. The left-hand pane of the window is separated from the right-hand 

11 . pane by an adjustable vertical splitter bar. The left-hand pane contains a tree control which displays the 

12 * folder hierarchy. The right-hand pane is split into two panes by an adjustable horizontal splitter bar. The 

13 pane above the horizontal splitter bar contains a list control that displays the contents of the currently 

14 opened folder in the tree control. The pane below the horizontal splitter bar contains a tab control with three 

15 tabs. The first tab contains a list control that displays the version history of the item in the tree control or 

16 list control that currently has the focus. The second tab contains a list control that displays the transaction 

17 log for the currently selected folder in the tree control. The third tab contains a list control that displays the 

18 recycle bin for the currently selected folder in the tree control. 

19 For any item selected in any of the three panes there is a popup menu that is activated by clicking the right 

20 mouse button while hovering over the selected item. The popup menu contains functions that are 

21 appropriate for the type of item selected. Also, the menus in the main menu bar are customized according 

22 to the type of item selected. 

23 6,2.1 .1 .Purpose of interface 

24 The Manage tool provides a user interface from the perspective of the AAM database. It allows users to 

25 navigate the folder hierarchy and to perform functions on the files contained in the folders. Many of the file 

26 management functions such as open, copy, move, rename, search, delete and properties are available 

27 through Manage tool. 

28 The Manage tool provides administrative functions to manage user access to the AAM database and to 

29 view transaction logs for transactions performed in the AAM database. 

30 The AAM database fully supports versioning for files and folders. The Manage tool provides the interface 

31 for versioning functions such as get latest version, check out, check in, branch, label, history, and 

32 differences. 

33 The functions of discovery, analysis, and deployment can be performed from the perspective of the folder 

34 hierarchy in the Manage tool. That is, users have the choice of interfaces for the discovery, analysis, and 

35 deployment tools. For example, a user can choose the Manage tool to perform the function of discovery 

36 from a folder in the hierarchy as a set of functions that set up and run discovery. Or the user can choose the 

37 discovery tool that presents the discovery process as a set of steps of which one of those steps is to choose a 

38 folder in the AAM database. 

39 6.2.1 .2.Functions 

40 6.2.1 .2.1. Discover 

D 

4 1 The Manage tool provides the ability to discover computer system and SQL database mventories from the 

42 selected folder in the tree control or list control. The discover function can be selected from the Tools menu 
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1 available in the main menu bar or the popup menu for the folder. The Discover menu item in the Tools 

2 menu is a popup menu containing menu items for Properties, Select Targets, Schedule, and Run. 

3 « Selecting the Properties menu item in the Discover popup menu displays the Properties dialog box with the 

4 Discovery page active in the dialog. The Discovery page provides the ability to choose the agents for 

5 discovery. 

6 Selecting the Select Targets menu item in the Discovery popup menu displays the Target Selection wizard. 

7 The wizard provides the ability to choose the target systems to discover via five different methods: host 

8 name, domain name, site name, IP subnet, or a list of host names. 

9 Selecting the Schedule menu item in the Discover popup menu displays the Task Scheduler dialog box. The 
10 Task Scheduler dialog provides the ability to run the discovery at one or more times in the future. 

* 1 Selecting the Run menu item in the Discover popup menu displays the Discovery Options dialog box. The 

12 Discovery Options dialog provides the ability to control various options that control how the discovery 

1 3 process is executed. After choosing *OK* in the Discovery Options dialog the discovery process starts and 

14 the Discovery Status dialog is displayed to show status messages returned to the AAM Workbench by the 

15 discovery process. 

16 6.2.1. 2.2. Analyze 

17 Tne Manage tool provides the ability to analyze computer system and SQL database inventories. The 

18 Analyze function can be selected from the Tools menu in the main menu bar or the popup menu for any set 

19 of f,,es and/or folders in the AAM database. Selecting the Analyze function from the Manage tool displays 

20 a child window containing the Analyze tool. 

21 6.2.1 .2.3. Deploy 

22 The Manage tool provides the ability to deploy an application from the selected configuration folder in the 

23 tree control or list control or from the selected version of the configuration folder in the history tab to one 

24 or more tar get systems. The deploy function can be selected from the Tools menu available in the main 

25 menu |> ar or the popup menu for the configuration folder or the configuration folder version. The Deploy 

26 menu item in the Tools menu is a popup menu containing menu items for Properties, Rules, Select Targets, 

27 Schedule, and Run. 

28 Selecting the Properties menu item in the Deploy popup menu displays the Properties dialog box with the 

29 Deploy page active in the dialog. The Deploy page provides the ability to configure the packaging 

30 application for deployment. 

3 1 Selecting the Rules menu item in the Deploy popup menu displays the Rules Editor dialog box. The Rules 

32 Editor dialog provides the ability to select rules for deployment and to edit their attributes. 

33 - Selecting the Select Targets menu item in the Deploy popup menu displays the Target Selection wizard. 

34 The wizard provides the ability to choose the target systems for deployment via five different methods: host 

35 name, domain name, site name, IP subnet, or a list of host names. 

36 Selecting the Schedule menu item in the Deploy popup menu displays the Task Scheduler dialog box. The 

37 Task Scheduler dialog provides the ability to run the deployment at a time in the future. 

38 Selecting the Run menu item in the Deploy popup menu displays the Deployment Options dialog box. The 

39 Deployment Options dialog provides the ability to control various options that control how the deployment 

40 process is executed. After choosing l OK' in the Deployment Options dialog the deployment process starts 

4 1 and tne Deployment Status dialog is displayed to show status messages returned to the AAM Workbench 

42 by the deployment process. 
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6.2.1 .2.4.Search 

The Manage tool provides the ability to search the A AM database for files or folders meeting a variety of 
criteria through the Search dialog box. 

The Search dialog box provides the user interface for performing searches on the A AM database. It 
contains fields for specifying names, text and locations to search for, as well as two check boxes that allow 
the user to specify if case should be ignored during the search and if subfolders of the specified location 
should be included in the search. The dialog also provides buttons to start and stop a search, choose 
advanced options, get help and close the dialog. The dialog also contains a list view for displaying the 
results of the search. 

The dialog contains a menu bar which provides a user interface to perform various versioning and 
management functions on items displayed in the results list, as well as changing the style and order or items 
in the results list. 

The dialog contains a status bar. with two panes. One pane shows the current path being searched in the ' 
database and the other shows the number of matches found. 

The dialog has a system menu available from the caption bar, as well as, close, minimize and maximize 
buttons in the caption bar. It is a modeless dialog to allow the user to continue to work in the manage view 
while the dialog is displayed. 

6.2.1 .2.5. Advanced Search Options 

Advanced search options including searching by custom properties, size, time and users are available to 
users through the Advanced Search Options dialog box. This dialog can be displayed from a button on the 
Search dialog box. 

The Advanced Search Options dialog box provides the user interface for setting advanced options during a 
search It is a modal dialog proving only *OK' and "Cancer buttons aside from the options controls. The 
OK button will dismiss the dialog and cause the specified advanced options to be set. The 'Cancel' button 
will dismiss the dialog leaving the options unchanged. Advanced options are maintained for the lifetime of 
the parent Search dialog box so that a user may bring up the Advanced Search Options dialog more than 
once to refine a search without the need to reset all advanced options each time it is displayed. 

6.2.1 .2.6.0pen and Open With 

The Manage tool provides the ability to open a file from the AAM database based on the file state. If the 
current user does not have the file checked out, the current revision of the file is displayed in read-only 
mode with the appropriate viewer. If the current user has the file checked out, the working revision of the 
ftte is opened for editing in the appropriate editor. If the viewer or editor is configured jn the system 
registry for the type of file selected, that viewer or editor is used. Otherwise, the Open With dialog box is 
displayed For the user to select an application to view or edit the file. In addition, the user is allowed to 
select any other application instead of the registered one to view or edit a file by selecting the Open With 
menu option. 

The Open function is also available on folders in the AAM database. If the Open function is selected on a 
folder in the tree control or on a version of a folder from the version history of the folder in the tab control a 
child window is displayed that contains the contents of the opened folder. 

Double clicking on an item in the tree control, list control, or history tab invokes the open function. 
6.2.1 .2.7.Move 



The Manage tool provides the ability to move all or part of the contents of an AAM database folder to a 
different folder. The user can use the Cut function to mark the items in a folder to be moved. The user can 
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then select a different folder and choose the Paste function to move the marked items from their original 
folder to the selected folder. Both the source and destination folders must be in a mutable state, otherwise 
the move is aborted and an appropriate error message is displayed. A folder is mutable if it is not versioned 
or it is checked out to the current user. 

6.2.1 .2.8.Set Current Version 

™?™ a ™ ge too 1 Provides the ability to select the version of a file or folder that will be the current version 
of that file or folder. The current version of a file or folder is the version that is displayed in the list control 
and the current version of a folder is the version of the folder that is opened when the folder is selected in 
the tree control. 

6.2.1 .2.9.State History 

The Manage tool provides the ability to view the state history of a revision of a file or folder. The State 
History dialog box can be displayed by choosing the 'History' button in the Properties dialog box for a 
revision selected in the history tab. The state history shows when an item was created, checked out and/or 
checked in. It also shows the user who put the revision into a particular state. 

6.2.1 .2.1 0.FIle Icons and State Icons 

The Manage tool displays the icon for a particular file type according to settings in the user's registry. If the 
default viewer for a file type is changed, the icon displayed for all files of that type in the A AM database 
will be changed to the appropriate icon for the selected viewer. 

The Manage tool displays an icon that represents the state of an item in the tree control, list control, or 
history tab to the left of the item icon. There are state icons to represent the following states: 

1) Checked out 

2) Checked out by multiple users 

3) Checked out exclusively 

4) Shared by two or more folders 

5) Pinned to a revision 

6) Labeled 

6.3. Discovery Tool 
6.3.1. Overview 

The discovery process involves running one or more agents on one or more target systems to gather an 
inventory of information about those systems. The inventories are then stored in the A AM database for 
analysis. 

The information required for a discovery can be broken down into three areas: a folder, tools, and targets. 
I he d| s<!overy folder is the location in the database where the discovered inventory will be stored when 
completed. The targets are the systems that the user wants to discover. The tools determine the discovery 
agents that will be run on the target systems to gather the inventory. ' 

6.3.1 .1 .Purpose of Interface 

The Discovery Tool provides a simplified interface tor performing discovery on target systems. There are 
two main areas in the interface, the command pane and the tab pane. The command pane consists of a set of 
command buttons for selecting the desired folder for discovery, selecting and setting the various discovery 
tools, selecting the target systems for discovery, and scheduling or running the discovery. The tab pane 
consists of a set of tabs on a tab control. Each tab displays a subset of all of the relevant information about 
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the current discovery operation, including the contents of the current folder, the selected targets and the 
tools that will be run on the selected targets. 

6.3.1. 2-Functions 



4 6.3.1 .2.1 .Command Pane 

5 The Command Pane contains five command buttons, which allow the "user to perform all of the necessary 
0 setup for discovery. The command buttons are Select Folder, Select Tools, Select Targets, Schedule, and 
/ Run. ~ * 

8 The Select Folder button displays the Open Item dialog box. This dialog allows the user to browse the 

V database and select the folder desired for discovery. When the user chooses "Open" the selected folder 

10 becomes the current folder. The selected folder is where the inventories of the selected targets will be 

„ f.e r ff c .°™Pletion of the discovery operation. The selected folder's contents are displayed in the 

Folder tab in the tab pane. 

13 The Select Tools button displays the Select Tools dialog box. This dialog allows the user to select which 

14 discovery too should be used to discover the selected targets. The choices include the computer system 

tl S5f° V 2 y ' ^ database d «covery tool, or the combined computer system and database discovery tool. 

10 When the user chooses "OK" the appropriate agents and sequence are displayed in the Tools tab in the tab 

1/ • pane. 

The Select Targets button displays the Target Selection wizard. This wizard simplifies the steps in selecting 
targets for discovery. Targets may be specified by host name, domain name, site name, IP subnet or a list of 
9 , hosts When the user chooses "Save" and subsequently "Close" the selected targets will be displayed in the 

Z1 . Targets tab in the tab pane. 

22 The Schedule button displays the Task Scheduler dialog box. This dialog allows the user to schedule the 

15 discovery operation to occur at one or more times in the future. 

The Run button displays the Discovery Options dialog box. This dialog allows the user to specify options 
for the discovery process. After the user chposes OK in the Discovery Options dialog the discovery 
process starts and displays a dialog, which provides current discovery status as well as error information 
kT % 1? . ° V6ry • The discover V operation will run the selected tool on each of the selected targets. 
oo As the discovery is completed for each target, the inventory of that target will be saved in the selected 

/y folder in the AAM database for later analysis. 

30 6.3.1. 2.2.Tab Pane 

3 1 The Tab Pane Provides a display for all information relevant to the discovery operation. 

32 The Folder Tab displays the contents of the selected folder. 

The Agents Tab displays a list control showing each of the agents selected for discovery as well as the 
desired parameters and other properties determining how the agents are to be run during discovery. It also 
sSuence COntr ° IS m ° difying the se <* uence b > addin S> editing or deleting agents or applications in the 

q r The Targets Tab displays information about the selected targets. This information includes the selection 

J» method (i.e. host name, domain name, etc) as well as any necessary user codes and passwords used when 

& discovering a given target. 
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6.4. Analysis Tool 
6.4.1. Overview 

The Analysis Tool provides for the statistical analysis and data mining of all facets of one or more 
discoveredsystem asset inventories. Various analysis tasks are "canned" and include application and 
process differencing, hardware and operating system differencing, database schema and properties 
d.fferencing, as well as consolidation candidacy determination. Additionally, a quick overview of various 
application and hardware/operating system differences are available in chart form. 

The Analysis Tool also provides for the creation of custom data mining via user-entered SQL statements 
thereby permitting a virtually unbounded capacity for analyzing system asset inventories. 
Finally, the Analysis Tool provides a high-level detail view of all discovered assets. 

6.4.1.1. Purpose of Interface 

The Analysis Tool is designed to provide a well-ordered yet flexible interface for the analysis of system 
asset inventories. Divided into two major fiinctions, the Analysis Tool provides for the navigation of 
system asset inventories via a tree view with associated detail in an explorer-like format, as well as a 
variety of categorically defined statistical functions. 

SSf^f 00 ' - S deVOid ° f any informatio " and through the inclusion of asset inventories, the 
In JZf, "? *? stat L ,su . c al views are populated and provide for easy manipulation of the information 
and data contained within the inventories. 

6.4.1 .2. Functions 

The Analysis Tool is divided into two panes, the tree pane and the tab pane. These two panes are described 
in more dctflil below. 

6.4.1.2.1. Tree Pane 

The tree view provides the interface for navigating through the asset inventories that are loaded for 
analysis. Within the tree view, each inventory occupies a top-level item similar to a disk drive or perhaps 
server within the network neighborhood as seen in the windows explorer. Each inventory will have a 
number of subordinate items that, for a given inventory, will include, but may not be limited to, an 
application node that contains all discovered applications, a process mode that contains all discovered 
processes, and a device node that contains all discovered devices. When any node that has relevant 
information to be displayed is selected, any and all detail is displayed in the details tab found in the tab 
peine 

6.4.1.2.2. Tab Pane 

The details tab provides a view to all of the detail information for any item selected in the tree view located 
in the tree pane. Information is displayed in a column wise table as attribute/value pairs. This view is 
informational only and provides no other functionality for the analysis of asset inventories. 

The application tab provides an interface for the analysis of application-specific differencing. This is useful 
lor discovering software level mismatches for applications and/or libraries that are distributed across 
multiple systems. 

k^Mrf^ PrOVidCS an in,CrfaCe f ° r me ana,ysis of Server hardware/operating system differencing. This 
is useful tor discovering commonalities and differences between server capabilities with a view toward 
consolidation or application migration. Servers that have like hardware/operating systems are likely 
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Hen?n^ f ° r app,ication "^olidation «d/or migration, whereas differences in hardware capabilities or 
deployed operating systems may prevent consolidation and/or migration. . paomues or 

™ e *?" S ° Hdat £ n teb P rovide s ^ interface for the analysis of applications with a view toward 
eSSnnl^r'fK * S e ! ared tOWa ? S 3 more fine ^ ained "na'ysis of consolidation candidates that 

• ° n ^ f * e SCrVer teb - Results obtaincd ftom this tab P rovJ de a list of applications that 
are compatible in terms of required libraries and hardware resources and are therefore target for 
deployment on a single server or cluster. 

The database tab 'Provides an interface for the analysis of database schemas and properties. This view is 

£££ 2! L h "Si T 10 enSUre *" dep, ° yed databaseS rcmain ^ and/or to dTcoJer 
databases that can be consolidated onto a single server. 

Itl!!!S ,ieS 3 ? inte ? aCe f ° r 4,16 disp,ay of high-level differencing information with a view 
LT'lcT^ . n J a " d/0r m, e ration - T ^ various charts are designed to reveal at a glance the likelihood 
cnn?^H t / ° n and/ ° r m £ rati ° n ° f a PP' ications «■ achievable, gach chart shows a Afferent aspec t ot me 
consolidation/migration problem and when taken together should point to areas in need of further anaSysls 

The results tab provides an interface for the display of the low-level analysis initiated by the application 
ZSSEZZTt and H d t baSB tebs - ™- a data-mining query has been SSSSS? 

hu««n nhtv ,? n f d , tabS * a corres P° nd ing Analyze button may be clicked. Clicking on an Analyze 

button obtains a results tab containing the corresponding query results. 



20 6.5. Deployment Tool 

21 6.5.1. Overview 



2TaS?£SE^ T ,fy ' ng ^ ° r m ° rc de P»oyment rules, copying applications* from 

1 ™ tem P orarv d,rector y °n *e user's disk drive, and compressing the files into a self- 
^ ? C PaCk3g t SS th6n distributed ^ executed on one or more target systems. Included 
v^ m P ! 5 f ^ ,nstr " c , tlons * at s P e <*fy *e directory where the files should be copied on the target 
bSZSJl name appHcation ' if *W in the ^at must be executed after the files have 

SSI^ff 'iS i PaCk nf a,ready CXiStS in 11,6 ^ directory the fo,lowin 8 Procedure is used to 

on vTme ISL^ overwritten If the file has version information, then the file will be overwritten 

KSSTSSir^ ,S """J* 16 VerSi ° n ° f * e file in * e target directory. If the file does not 

i ^ * e ,aSt modified tfane stam P s wi » be compared. The file will be 

overwritten if the packaged file has a later timestamp than the version of the file in the target directory. 

L^ n /°T'i° n , : reqUir t d for a deployment can be broken down into four areas: a configuration folder, a 
SSteSEE \ 1 TFT ^ ^P^nt configuration folder is the location in the database 
meTiSrd£™nT,h de P ,oyme " t P^^e 8 have heen saved. The package description specifies 
hLTe^Z f££ ^ " am e of the application, if any, in the package to execute after the files have 
tara. S!2 ? PaC ^ ge : Th£ fU,eS Ermine if minimum conditions of deployment are met by the 

S Z5^£S2$£££T m actua,,y deployed - The targete are the systeras that * e ™ 



40 6.5.1 .1 .Purpose of Interface 



S£ ^fI~ a P T dCS a s,m P Iifi ed interface for performing deployment of application assets to 

^ ^° mam areaS in Ae interface ' the command pane and the taopane. The 
AAZdalb^e fnr n H St , ' "* ° f I COmmand bM for electing the desired configuration folder in the 
i depl0 y ment ' "e'ecting and setting up the various deployment rules, and scheduling or 
running the deployment. The tab pane consists of a set of tabs on a lab control. Each «kb displays a subset 
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of all of the relevant information about the current deployment operation, including the contents of the 
current configuration folder in the A AM database, the selected deployment rules, and the selected target 
systems. & 

6.5.1 .2. Functions 



6.5.1 .2.1. Command Pane 
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The Command Pane contains five command buttons, which allow the user to perform all of the necessary 
and RurT yaGiaL The command buttons a» Define Package, Select Rules, Select Targets, Schedule, 

The Define Package button displays the Open Item dialog box. This dialog allows the user to browse the 
database and select the configuration folder desired for deployment. When the user chooses "Open" the 
selected configuration folder becomes the current folder. The selected configuration folder is where the 
app ication assets are stored that will be deployed to the selected targets upon completion of the 
dep oyment operation The selected configuration folder's contents are displayed in the "Package" tab in 
the tab pane. The Package tab also allows the user to define the target directory and the application in the 
package to execute. 

IS 5 C,eCt ^ eS bU ^ n di ! P,ayS Ru,eS Editor dia, °S box - This dial °g a " ow * *e «ser to select rules and 
edit their attributes. The rules available to select from include: 



1) 
2) 
3) 
4) 
5) 

6) 



The minimum amount of free disk space required on a specified drive. 
The minimum number of processors required. 
The minimum amount of memory required. 
Do not deploy if the application is already installed. 

Do not deploy if the application has a dependency on one or mpre other applications to run, and 
any one of those other applications is not installed. 

Do not deploy if the application has a conflict (cannot run)' with one or more applications, and any 
of those applications is installed. ' 

Sit^nfhe So panT * ^ ^ ^ b °* °» M -displayed in 

The Select Targets button displays the Target Selection wizard. This wizard simplifies the steps in selecting 
. ™ P< 2 ment " Targ6tS may be S P ecified bv host name > domai " " a ™. site name, IP subnet or a lisf 

£££5 f^ET and subseqaently " c,ose " the sdected targete wi " be disp,ayed in 

The Schedule button displays the Task Scheduler dialog box. This dialog allows the user to schedule the 
deployment operation to occur at some time in the future. 

The Run button displays the Deployment Options dialog box. This dialog allows the user to specify options 
for the deployment process. After the user chooses OK in the Deployment Options dialog the deployment 
fIS S . P yS * L dia, °8' which Prides current deployment status as well as error information 
relating to the deployment. The deployment process will perform the following steps. 



1) 



2) 

3) 

4) 
5) 



If there are deployment rules specified, get the inventory from the target system and evaluate the 
ru es against the inventory. If a rule evaluates to false, display a message box that indicates the 
rule that failed and provides buttons to override the rule or to cancel the deployment operation. 
Copy the files m the selected configuration folder from the A AM database to a temporary 
directory on disk. 

ondSf 0 3 f,IC COntain ' ng the de P ,0Vme ™ information and put it to the same temporary directory 

Compress and copy the files from the temporary directory into a self-extracting package. 
Copy the package to the target system and execute the package. 



•W* UNISYS RESTRI«!H@Pe©NFIDENTIAL 

C:\WlNNTVPmr.les\AlenuaY\DesktopUAM 2.0 Funelional Spec.doc 
65 



Title: Application Asset Manager for Application Sentinel 1.1 
Type: Functional Design Specification 
Owner: Jonathan Ziebel I 



68905330 
Version A 



6) The package will decompress the files and copy them to the target directory specified in the 
deployment information file. 

7) If the deployment information file indicates a tile to execute, the package will execute the file. 



The Tab Pane provides a display for all information relevant to the discovery operation. 

The Package Tab displays the contents of the selected configuration folder in the A AM database and other 
package information. 

The Rules Tab displays a list control showing each of the rules and their attributes selected for deployment. 

The Targets Tab displays information about the selected targets. This information includes the selection 
method (i.e. host name, domain name, etc) as well as any necessary user codes and passwords used, target 
directories used, and the application executed when deploying to a given target. 




7. 



Issues and Risks 



None 
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Appendix A. Definitions, Acronyms, and 
Abbreviations 



3 
4 



None 
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Appendix B. Alternatives Considered 



None 



WMSV&RESTRICTED CONFIDENTIAL 

C:\WlNNTVProriles\AlcmzaYADesktop\AAM 2.0 Functional Spec.doc 
68 



Title: Application Asset Manager for Application Sentinel 1 . 1 
Type: Functional Design Specification 
Owner: Jonathan Ziebell 



68905330 
Version A 



Appendix C. Functional Design Summary 



Requirement ID 
T1644 


Requirement 

Application Deployment - Detection of application differences 

SlK 9 "? W a PP" catlon to applications existing on a system to detect any 
conflicts or issues before a rollout. ' 

Solution requires developmental system to be present in order to determine 
now the new application is constructed. Integration with a know!ednpha«o ic 
not supported in the Application Sentinel 1 .^timeframe fSiSSSSST 
Sentinel 1 .1 the staged application will be compared to the production 
application to determine process/DLL naming and version conflicts. 


T1652 


Application Deployment - Reporting '. ~~ — 

Produce a report of configuration changes for applications that are 

^hf™!" 9 " , ■ a PP' ic , ations wi " need to be running in order for configuration 
change analysis to take place. 


T1653 


Application Availability - Backup and Recovery 

The Application Asset Manager can assist with the sizinq of a svstem based 
on a given set of previously AAM discovered applications. Definition of a 
recover process is outside the scooe of the AAM 


T1656 


Application Maintenance - Configuration Management 

a!!? 1 .. ,th the u P dattn 9 application configurations on the ES7000 

AAM will provide the abilitvto deploy aoDiication assets to ES700O partitions 


T 1663 


Maintainability of Application Sentinel : F 

APP'Jation Sentinel should be able to accept plug in modules or additions 
that deal with specific areas or applications. 

AAM will provide open interfaces which can be called from outside tooling 
(i.e. plug-ins) to expose both data and functionality for their respective 
apphca ion domains. AAM will integrate with and provide open interfaces to 
the Software Backplane architecture currently under definition 


T1838 


Operating Environment " 

The following are execution environments for Application Asset Manaoer 


T1 838.1 


windows 2000 Data Center ; a 

Application Asset Manager will support this platform 


T1 838.2 


windows 2000 Advanced Server ' ~ 

Application Asset Manager will support this platform 


T1 838.3 


32-bit Windows .Net Data Center Server '' '~ 

Qualify Application Asset Manager for .Net Server. Will not internally qualify 
Application Asset Manager. Launchpad and Rules Engine for .Net Server 
release for Application Sentinel 1.1. Resource limitation* 


T1895 


Application Asset Manager - SQL Tools 

Application Asset Manager SQL Tools . The child requirements define SQL 
tool requirements for Application asset Manager 


T1 895.1 


SQL Analysis Tools Requirements 

Implement SQL Analysis Tools features below as described by SQL Server 
Consolidation 1 .0 MSOR item M906. 

-The Application Asset Manager discovery and analysis tooling will detect 
differences in roles, users, aliases/defaults, rules (unctions, user defined 
datatypes, user messages, tables, indexes, views, extended procedures, 
procedures and triggers. 

lH? e A PP lication . Asset Manager discovery and analysis tooling will detect 
and report on activity (clients, logins, and rtaf a h aco .1^ 9 
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T1 895.2 



T1935 



T1 970.2 



T1981.2 



T1 982.2 



T1 983.1 



T1 997.2 



T1 999.2 



T2007.2 



Migration Tools requirements 

The Application Asset Manager will allow the user to discover and report on 
usercode and password information. 

The ability to migrate usercodes/passwords to other SQL database 
instances will not be provided in this release. 



White paper for Application Asset Manager 
White paper will be made available on Application Asset 



Manager 



Security of Application Sentinel 
Application management facilities of Application Sentinel do not introduce 
security breaches. 



Application Deployment - Updates " " — 

Automatically detect the level of software installed on distributed systems 
and bring them up-to-date depending on the deployment rules The 
Application Asset Manager will provide the capability to automatically 
discover and compare versions of installed applications across server 
domains. The Application Asset Manager will permit the Administrator to 
define hardware resource requirements prior to deployment of an 
application. The AAM will pre-validate that the resources are available on the 
target system prior to deployment. The administrator will be notified if 
defined conditions are not present. The administrator will have the ability to 
override the deployment rule if necessary. 



Application Deployment - Distributed Applications " 
The Application Asset Manager will automate deployment of applications to 
one or many servers 



Application Deployment - Software Inventory 
Application Asset Manager provides the ability to automatically, through 
scheduling of AAM remote discovery agents, maintain an inventory of 
executing applications and their dependencies. 

The capability to determine dependency information cannot be determined 
unless the application is executing. 



Internationalization/Localization 
Implement Application Asset Manager user interfaces to be 11 8N compliant. 

Application Maintenance - Version Control 

The Application Asset Manager will maintain an inventory of all metadata 
SUSSf*" 0 Insta,fed and executing applications and hardware resources of all 
VMWare instances, Slot Appliances and partitions). The metadata 
information will be versioned in the AAM (as defined through best practices) 
for purposes of comparing last known good 1 application execution 
environments. In the event of future server degradation, as a result of newly 
deployed applications or a alteration of server resources, comparisons can 
be made between last know good server instance vs. server instance that 
failed through the AAM Analysis Manager indicating immediately the 
differences (application or server resource) between the two. Recovery 
would then consist of either application redeployment or manual reallocation 
of serve resources to quickly recover to last known good server state. Data 
recovery, as is often the case, is the responsibility of the runninq application 
upon re-initialization. 



Internationalization of Application Asset Manager 
Application Asset Manager user interfaces will be 118N compliant. 
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T2019.2 



T2021.3 



T2023.4 



T2053 



T2054 



T2055 



T2056 



T2152.1 



T2151.1 



Management Server repositories " ~~ " ~" 

fnn^°^ e / epositories that Server entfnel supports. These are MSDE 
2000, SQL Server 7.0, and SQL Server 2000. 

AAM will continue to use proprietary data stores for the Application Asset 
Manager product. However, the ability exists in the product to export 
captured data to MSDE 200o/sQL Server 7.0 and SQL Server *nnn 



Managed Applications and Databases 
Application Asset Manager will assist in the process of deploying 
applications both previous and prior revisions of the application and 
database artifacts. 

Persisted data and the restoring thereof is the responsibility of the 
applications data restore process. y 



Planned Application Downtime 
Application Asset Manager will assist in the process of deployinq 
applications both previous and prior revisions of the application and 
database artifacts. 

Persisted data and the restoring thereof is the responsibility of the 
applications data restore process 



Modify Export to save deltas instead of entire file versions. 



Launch Batch and Script files. 
Enhance the Discover and Manage views of thd Workbench to launch batch 
files and scripts in addition to applications 



Use temporary file for Discovery data. 
Route discovery through a temporary folder in the file system that is created 
before discovery and deleted after discover y. 



Provide load status in the Workbench. 

S?£? ,0 f StatUS in the Mana 9e. Discover, and Analysis views of the 
workbench. 



Application Deployment - Deployment Rules 
The Application Asset Manager will permit the Administrator to define 
KSr^? resou ^ e requirements prior to deployment of an application. The 
AAM w.H pre-valldate that the resources are available on the target system 
prior to deployment. The administrator will be notified if defined conditions 
are not present. The administrator will have the ability to override the 
deployment rule if necessary. 



Application Deployment - Manual Intervention 
Any administrator defined resource rule can be overridden by the 
Administrat or using the Application Asset Manager 
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1 . Document Control 

This document was generated using the PPG Template Generator, 3490 3880, revision J. 

1.1. Change History 



Version 

"a " 


Description 

. ) 


~B 


Initial Revision 




Updated per review 











5 1.2. Document Cross Reference 



None. 



UNISYS RESTRICTED CONFIDEN*ESE^^^^ 
C:\WINNTVPr0filcs\Alem2aY\Deskt0p\AAM l.O Functional Spec doc 
77 



.6 O M-SS 7 i* £ , 03 JL 1 



Title: Application Asset Manager Server Consolidation Features " fiR7<waa< nm 

Type: Functional Design Specification Ver J^ p 

Owner: Jonathan Ziebell version o 



i 2. Introduction 



2 2.1. Purpose 



3 
4 



6 
7 



11 
12 



The purpose of this document is to provide a functional level description of the proposed new features 
and/or modifications in the Application Asset Manager (AAM) for Server Consolidation. 



5 2.2. Scope 



The features and user interfaces described in this document are described in the context of the AAM 
Configuration Wizard and the AAM Shell Extension (the shell). They are additions or modifications to the 
» Configuration Wizard or the shell. 

9 As a functional design specification this document describes only functional aspects of features and does 

1U not provide information regarding algorithms, data flow, etc. 



3. Functional Description 



13 AAM will provide Server Consolidation users the ability to run or schedule server consolidation tools to 

J4 discover and analyze their server application information, providing trace-ability of the server consolidation 

15 assets throughout the project's lifetime by storing all versions of the assets. 

16 Unisys representatives must be able to install and configure AAM on their laptops in order for AAM to be 

i o " . * C " s !° K m ^ r SItes where Unis y s is under contract to provide server consolidation services. -To facilitate 

jo this the AAM Configuration Wizard will provide users the ability to create AAM databases that are much 

on a !Ii^ n ^ OSC Created by the current version of tbe Configuration Wizard. The new minimum size of 

ZO an AAM database will be 600 MB. The old minimum size was 1.4 GB. 

21 3.1. Server Consolidation Extensions 

22 A new extension will be loaded into the AAM database at database creation time from the AAM.xml 

is initmlizat.on file. The presence of the "Server Consolidation Project" extension will cause the shell to add 

M Server Consolidation Project to its New 'menu as well as a new Server Consolidation menu to the Windows 

a explorer main menu bar. The Server Consolidation menu will contain items to create a new Server 

Consolidation Project, configure andTun Discovery, run Analysis, and view Server Consolidation Help. 

27 (Requirements T1009,T1010,T1049) 

28 3.2. Server Consolidation Projects 

29 in order for AAM to properly run server consolidation tools and update the discovered assets a new 

Jt> container type, "Server Consolidation Project" will be created in AAM. A Server Consolidation Project 

will contain server consolidation assets. A Server Consolidation Project will store all revisions of the assets. 
tor each server consolidation project a Server Consolidation Project will be created in AAM to provide a 
V| ew into the server consolidation history. 

34 To manage the project from the AAM shell, initially, a user will create a Server Consolidation Project and 

« ass ' g " ", a w<>rl «ng path. The user can then discover and analyze their server information via the Discover 

JC> and Analyze operations. (Requirements TI009) 
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i 3.3. Discovery Properties 



As with any other projects, a user will have the ability to view and modify properties for Server 
Consolidation Projects. The Discovery page in the Properties dialog will allow the advanced user to view or 
modify the discovery process sequence. A Discovery Wizard will guide new users through the process of 
configuring the process sequence for Server Consolidation Discovery. 



6 3.4. Discover 



A user will have the ability to Discover Server Consolidation Projects. The Discover operation will run the 
discovery process sequence then update the Server Consolidation Project with any new revisions of the 
discovered server consolidation files. Optionally, a user can choose to get server consolidation files from 
the database before the discovery process sequence is run. 



3.4.1. Run Discovery Process Sequence 



The Discovery Process Sequence is an ordered list of applications or utilities that perform the actual 
discovery. The Application Asset Manager provides one discovery application but a user could optionally 
use any applications that discover server information. The applications are run one at a time and in order 



15 3.4.2. Updating the Database 



After the discovery process sequence has run, AAM will update the database accordingly. That is if the 
applications in the sequence have output new server consolidation assets or modified existing assets they 
will be added to (if they don't already exist) or updated in the Server Consolidation Project. In cases where 
tiles already exist m the database and need to be updated by the AAM or cases where new files are added to 
the database the user will be allowed to specify various options specifying the state of the objects in the 
database as well as files in the file system. 



22 3.4.3. Getting Files 



Optionally before the discovery process sequence runs the user can choose to retrieve server consolidation 
tiles from the database. The AAM will retrieve the Server Consolidation Project to a user specified source 
tolder. A user will be allowed to specify various options specifying desired file revisions, file system 
options, etc. 



27 
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3.5. Analysis Properties 



Proiel?, °ThtTT C *' 3 *? !T e thC abUUy t0 View and modif y Parties for Server Consolidation 
^S^S^ 10 Pr ° PertieS dia, ° g Wi " aUOW «* » - -dify the" 



s 3.6. Analyze 



io 3.6.1. Getting Files 



S S TT ""f WiU re,rieVe S6rVer COnSO,idation fi,es from the database, 
be alk^.^ InTr * 6rVer Conso,,daUon to a user specified destination folder. A user will 

be allowed to specify various options specifying desired file revisions, file system options, etc 



3.6.2. Run Analysis Process Sequence 



t£ S S1 ! ?** S x e ^ uence is an ordered of applications or utilities that perform the actual analysis 

ff Ma ^g- Provides one analysis application but a user could optionally usTanT 
apphcahons that analyze server information. The applications are am one at a time and in order 



is 3.6.3. Updating the Database 



Optionally, after the analysis process sequence has run, AAM will update the database accordingly That is 
to *5 ITT^ h r T PUt nCW SCTVer Nidation assets or modified exSg'asse ts 

JtoTfiL^SJ? ^ y K d0 ," 1 l W Cady 6X580 ° r Updated in the Server Consolidation Project. In cases 
rJ^S L?L y eX f m the database and need to to »P dated by the AAM or cases where new files are 

fnrraLtr^ 
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2 4. User Interfaces 

3 4.1. Configuration Wizard 

4 4.1.1. Overview 

5 4.1 .1 .1 .Purpose of interface 

4.1.l.2.Functions 

roSttS^ 9 of registering and starting database services, creating an 
initialing ^'SX^^ZTw^r ^ *" ^ Z 



6 

7 

8 

9 
10 
11 



12 4.1. 1.3. Form 



13 
14 
15 
16 
17 



18 



£o^n c :s 

summary will be d^^JK^JESEZE"- P"*' T " tared Mi inf °™«°n. • 
not to the user liking! a Baci button SaSow L^LfT V™** ** Snformation - » the information is 
pageof the wizard * displaye*^^ 



m Application Asset Man.,7r Conn,,,., *,,r, W, ard « .. H | ^1 



Welcome to the Application Asset Manager 
Configuration Wizard 



The Configuration Wfeard wflj guide you through the steps 
required to configure the Application Asset Manager. 

To contfoue, select Next 
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Field 

Next 



Cancel 



Description 



Advances to th e next page in the ConfiguratioiTw^ " 



Exits the Configuration Wiza rd without configuring AAM. 



Sp Application Asset Manager ConfiauraHnn \u's4^a vr-:s 
-r„ ,., — JCI uu,,I, guracion Wizard^fe?*^^^ 




Password 



Domain Name 
Back 



Next 



Cancel 



The user's Windows login password. 
The user's Windows login domain name. 
Returns to the Welcome page — — - 



*~w» w »j w mc welcome page. 

Advances to the next page in the Configuration Wi^T 
exits the Configuration Wizard with™.* • a a 



the Configuration Wizard without configuring AAM~ 
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& Application Asset Manager S^^Ml^^^SBSSBM ^^gg 




Create Database 



Database Name 
Database Size 



Database Users 



Back 



Next 



Finish 
Cancel 



Determines whether the wizard will create an AAM universe and 
database. Default value: checked. 



The name of the database to create/Default value: AAM 



The size of the database in database items. Default value: 10000. 



The maximum number of users that can access the database at the 
same time. Default value: 50. 



Returns to the Login Information page 



Advances t o the next page in the Configuration Wizard. 



Advances to the Configuration Summary page using default 
settings for audit and data storage partitions- 



Exits the Configuration Wizard without configuring AAM. 
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&_ Application Asset M anager Confi gurat^^iM^, 



Database Storage Information - Audit Partitions 

Please enter the mformation requested 



m 




Field 

Number 



Sike 



Location 



Browse 



Back 



•Next 



Finish 



Cancel 



Description 



•>••:;• -;&| 



The number of audit partiti ons to create. Default value- 2 

The size of each audit partition t o create. Default va l,,*- i nn A/in 

I he fiiri»I*tr\r\r n**tU ink. . .L- i. . ~TT . - - _ — — 1 



— — — — ■— " gjat r: "cau'i vaiue: iuux 

The directory path where the audit partitions will be created 
Default value: installation dir ectory>\AAM\D hs\A AM 



Displays a dialog that allows the user to browse for a directory 
The Location box is updated to the pa th of the selected d,WtX~ 
Returns to the Database Informarinn r » r ~ 



-7~i — ■ — w. MWMW , page. 

Advances to the next page in th e Configuration W l^T 

Advfliir'Ac tr\ tha rv^r: #» T ■ 



Advances to the Configuration Summary page using default 
settings for data storage p artitions 



Exits the Configuration Wizard without config urin^AAM^ 
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'M Application Asset Manager Configuration Wizard 



Database Storage Information - Data Partitions 

Please enter the information requested 



fa '- ~-££bt 




Field 



Number 



Size 



Location 



Browse 



Back 



Finish 
Cancel 



Description 



The number of data partitions to create. Default value: 2. 



The size of each data partition to create. Default value: 100 MB 

T-l i: i. 71 r~ — ~rr~z . 



The directory path where the data partitions will be created. 
Default value: i nstallatio n directory>\AAM\Dbs\AAM. 



Displays a dialog that allows the user to browse for a directory. 
The Location box is updated to the path of the selected directory. 



Returns to the Database Storage Information - Audit Partitions 
Page- 



Advances to the Configuration Summary page 



Exits the Configuration Wizard without configuring AAM. 
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Configuration Summary 

Please verify the configuration specifications. 




Field 


Description 


Configuration specifications 


The list of options specified on the Login Information page* 
Database Information page, Database Storage Information - Audit 
Partitions page, and Database Storage Information - Data 
Partitions page. 


Back 


Returns to the page displayed before advancing to this page. 


Configure 


Advances to the Status page and begins the configuration process. 


Cancel 


Exits the Configuration Wizard without configuring AAM. 
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Title: 


Application Asset Manager Server Consolidation Features 


68763895-003 


Type: 


Functional Design Specification 


Version B 


Owner: 


Jonathan Ziebeil 






Field 


Description 


Status 


Displays messages that tell the user what part of the configuration 
is currently underway and updates the progress bar. 


Cancel 


Aborts the configuration process and exits the Configuration 
Wizard. 
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0 Application Asset Manager . Cohnguratidn^Wiz^^^^a 



Application Asset Manager Configuration 
Wizard Completed 

The ^Configuration Wizard has successfully configured the 
Application Asset Manager. 

You can begin using the Application Asset Manager 
immediately after closing the ^figuration Wizard 



Select Close to exit the Configuration Wizard 




Field 



Close 



Description 



Exits the Configuration Wizard. 



4.1. 2. User Manual 



Using the Configuration Wizard 

?onfit^l b „ egm "f 8 "E Ap P ,ication Asset Manager, you must run the Configuration wizard The 
SSte tC T ^ y ° m ,0gin CrCdentia,S and to ^ and S Action 

AsS Manaf er %SSE^^ y ° U m ° dify database attributes usin 8 * e Application 

Asset Manager Persistence Management snap-in to the Microsoft Management Console (MMC) 

Notes: 

# TeSnaf ?HS,?c e Ap P Hcati ° n , ^ Mana e e r *™ a Terminal Services session, you must log out of 
Terminal Services session and log back on before running the Configuration wizard. 

' y^r taSSSiSS "EE" l ° g ° n yOUr Wiridows ,0 8 on credentials. Validating 

your log on credentials on Windows 2000 systems requires that your user account have the "Act as oar, 

y f tH,S PrivUe8e iS " 0t 561 fOF yOUr USCr account ' the Configuration 
2 ApMotZ^M ^ 3 meSS38e ab ° Ut thiS Situati ° n - After you have successfully configured 

part ti, ToZ^o i^Z ^ y °, U rcm ° Ve thiS Privilege from your USCT account - The "Act as 
part of me operating system privilege is not required in order to use the Application Asset Manager 
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Perform the following steps to run the Configuration wizard: 

1. From the Start menu, select Programs, Unisys, Application Asset Manager, and then Configure. 
The Configuration wizard appears. 

2. Choose Next. 

The Login Information wizard page appears. 

3. Type your Windows user name in the User ID box. 
Note: The user name is case-sensitive. 

4. Type your Windows password in the Password box. 
Note: The password is case-sensitive. 

5. Type the domain in which your workstation operates in the Domain Name box. 

6. Choose Next. 

wTchlt e OK r r2 e ' ° r name is inCOTTect ' an error ^sage * displayed. When 

Inf™£ „ Cm ! r meSSagC dial °8 boX ' me Configuration wizard returns to the Lorin 

Information wizard page allowing you to correct your login information. & 

The Database Information wizard page appears. 

Syou r e S coS n ?S a fA Ch r k J" ? CheCked Whe " the Database "formation wizard page appears. 
yJu^etTZtl PP ^ ManaSer for ^ fim dme ' this is *e correct choice for 
you because you do need to create a database in order to use the Application Asset Manager If 

If jou to™ checked .he CreMe Database check box. continue .1 siep 8. otherwise, akip » siep 19 
Note: The database name cannot contain blank characters. 

ft£»£ ft a ^ S 26 iS 10000 fi ' es ' fo,dere » and ^ minimum 

uawuase size is iuuu, and the maximum ,size is 1000000. 

JofcS OK ^ ° UtS J d ? ° f a "° Wed ran ^ an *™ message is displayed. When . 
SfannZta wTzS i^SI meSSa86 dia, ° g * e Co " fi g"™tion wizard returns to the Database 
mrormation wizard page allowing you to correct the database size. 

n-be^ 

^JS^^ » u,side o ^ e a, !° wed range > an e ™ 

returns to the Database ^„fi"^?- • j the err ° r mcssa « e di a>°S box, the Configuration wizard 
daE us«s »"format,on w,zard page allowing you in correct the maximum number of 

Mi^S^l^ T a /. d the >k NeXt button wi " bc disabled if y°« "«ve already created an ' 



7. 
8. 
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11 



14. 
15. 



Choose Next to specify database storage settings or skip to step 19 to accept the default or current 
database storage settings. 

The Database Storage Information - Audit Partitions wizard page appears. 

Note: An audit partition is a file used to manage database transactions that are in progress. If a 
transaction is aborted due to an error condition or a user request, the information in the audit partition 
is used to roll back the transaction to its initial state. 

12. Type the number of audit partitions that will be allocated during the configuration of the database in 
the Number box. By default the number of audit partitions is 2. The minimum number of audit 
partitions is 2. The maximum number of audit partitions is 10. 

Note: If you enter a number of audit partitions outside of the allowed range, an error message is 
displayed. When you choose OK on the error message dialog box, the Configuration wizard returns to 
the Database Storage Information - Audit Partitions wizard page allowing you to correct the number of 
audit partitions. 

13. Type the size of an audit partition in the Size box. By default the size of an audit partition is 100 MB. 
The minimum size of an audit partition is 100 MB. The maximum size of an audit partition is 2000 
MB. 

Note: If you enter a size of an audit partition outside of the allowed range, an error message is 
displayed. When you choose OK on the error message dialog box, the Configuration wizard returns to 
the Database Storage Information - Audit Partitions wizard page allowing you to correct the size of an 
audit partition. 

Type or use the Browse button to specify the location of the audit partitions in the Location box. 

Choose Next. 

«*■ 

Note: If the total size of the audit partitions and/or the data partitions exceeds the amount of free space 
on the disk where the audit and/or data partitions will be located, an error message is displayed. When 
you choose OK on the error message dialog box, the Configuration wizard returns to the Database 
Storage Information - Audit Partitions wizard page allowing you to correct the number, size and/or 
location of the audit partitions. 

The Database Storage Information - Data Partitions wizard page appears. 

Note: A data partition is a file used to store and manage the files, folders, and projects stored in the 
database. 

16. Type the number of data partitions that will be allocated during the configuration of the database in the 
Number box. By default the number of data partitions is 2. The minimum number of data partitions is 
2. The maximum number of data partitions is 20. 

Note: If you enter a number of data partitions outside of the allowed range, an error message is 
displayed. When you choose OK on the error message dialog box, the Configuration wizard returns to 
the Database Storage Information - Data Partitions wizard page allowing you to correct the number of 
data partitions. 

17. Type the size of a data partition in the Size box. By default the size of a data partition is 200 MB. The 
minimum size of a data partition is 200 MB. The maximum size of a data partition is 2000 MB. 

Note: If you enter a size of a data partition outside of the al lowed range, an error message is displayed. 
When you choose OK on the error message dialog box, the Con figuration wizard returns to the 
Database Storage Information - Data Partitions wizard page allowing you to correct the size of a data 
partition. 

18. Type or use the Browse button to specify the location of the data partitions in the Location box. 

19. Choose Finish. * 
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1 Note: If the total size of the audit partitions and/or the data partitions exceeds the amount of free space 

2 on the disk where the audit and/or data partitions will be located, an error message is displayed. When 

3 you choose OK on the error message dialog box, the Configuration wizard returns to the Database 

4 Storage Information - Data Partitions wizard page allowing you to correct the number, size and/or 

5 location of the data partitions. 

6 The Configuration Summary wizard page appears. 

7 20. Verify the information displayed in Configuration Specifications box. If you would like to change any 

8 of the information listed in the box, you can use the Back button to return to any wizard page and make 

9 the desired correction. * 

10 21. Choose Configure. 

1 1 The Status wizard page appears. A status bar is displayed on the wizard page to monitor the progress 

12 of the configuration process. 

13 Note: Be patient If the Configuration wizard will be creating a new database, the configuration 

14 process will take several minutes to complete. 

15 22. Choose Close. 

16 You can now operate the various components of the Application Asset Manager. 

17 Note: You can only run the Configuration wizard once per installation. If you need to adjust database 

1 8 parameters, you can do so using the Application Asset Manager Persistence Management MMC snap- 

19 in. 

20 4.2. Menu Commands 

21 4.2.1. Overview 

22 4.2.1 .1 .Purpose of Interface 

23 In Windows applications, menus are made available to the user to invoke various functions. 

24 4.2.1. 2.Functions 

25 The functions are: 

26 • New Server Consolidation Project 

27 • Discovery Wizard 

28 • Discover 

29 • Analysis Properties 

30 • Analyze 

3 1 • Help for Server Consolidation 

32 (Requirements T1010, T1049, T1050, T1218, T1220) 

33 4.2.1 .3.Form 

34 A Tool Menu combo box will be added to the General Options page, as shown in the next image. 
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Analysis, and Help menu items. The mS^'2SE? T "J" CO " tain New Pro j«*' Discovery, 
W,zard and Discover menu items. The SSSi JS It?" diSP ' ayS 3 Submenu fining 

Properties and Analyze menu items. The fo lowinTtl?^ k ^T*' disp,ayS a Submenu containing 
Consolidation Tools menu in the Explore meLu SL^w 8 ? ° W ^ a PP earance °* the Server 8 
selected. The second image shows H^iX!^ * With the DiscOV ^ 
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Type: Functional Design Specification Version B 

Owner: Jonathan Ziebell 




Field 


Description 


New Project 


Creates a new Server Consolidation Project in the current folder. 
Once the user has edited the name for the new project, the Set 
Working Path dialog will be displayed to give the user the 
opportunity to set the working path for the project. 


Discovery/Wizard 


Starts the Discovery Wizard that will guide the user through the steps 
to configure and run discovery. 


Discovery/Properties 


Displays the Discovery page in the Properties dialog that allows the 
user to view and/or modify the discovery execution sequence. 


Discovery/Discover 


Runs the last saved Discover operation. 


Help 


Displays online help specific to server consolidation. 
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Field 

New Project 


Description 

Creates a new Server Consolidation Project in the current folder. 
Once the user has edited the name for the new project, the Set 
Working Path dialog will be displayed to give the user the 
opportunity to set the working path for the project. 


Analysis/Properties 

Analysis/Analyze ~ 
Help 


Displays the Analysis page in the Properties dialog that allows the 
user to view and/or modify the analysis execution sequence. 
Runs the last saved Discover operation. 
Displays online help specific to server consolidation. 
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1 

2 



A menu item labeled Server Consolidation Project will be added to the File/New menu in the main menu 
bar and in the list view popup menu as illustrated in the two images below. 




My Computer 
MyNetworfcPfeces 

AecydoB&i 

Y ' tiS Internet Explorer 
& £8 AppScaUon Asset ttywger 
T-^p AAM on US4Y-ZIESOJV-1 



. .L1.V I '.' 



Field 


Description 


New/Server Consolidation 
Project 


Creates a new Server Consolidation Project in the current folder. 
Once the user has edited the name for the new project, the Set 
Working Path dialog will be displayed to give the user the 
opportunity to set the working path for the project. 
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3 
4 



6 
7 
8 
9 

10 
11 
12 

13 
14 

15 
16 




Creates a new Server Consolidation Project in the current foldeF 
Once the user has edited the name for the new project, the Set 
Working Path dialog will be displayed to give the user the 
opportunity to set the working path for the project 



4.2.2. User Manual 

m!™,?, r T ConsoUda « on Pr °i«* When the user selects the Server Consolidation Tools/New Proiec 

ESS-— »-=s=s3sS3E, 

S^y W w!^rr ,eCtS SCrVer ConSolidati °" Too.s/Discovery/Wizard menu bar item, the 
DSeTpI^s stT S£,eC,S SerV6r Consolidatio " TooLs/Discovery/Discover menu bar item, the 
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Properties: When the user selects the Server Consolidation Tools/Analysis/Properti* 
analysis configuration wizard starts. y pem 



:es menu bar item, the 



Analyze: When the user selects the Server Consolidation Tools/ Analysis/Analyze menu bar item 
analys* process starts on the currently viewed project, or on any ^SSS^SSS!^ 

SSyT >en ^ USCr Se ' eCtS * e ^ Co™™*™ Tools/Help menu item, help for server consolidation 
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4.3. Discovery Wizard 
4.3.1. Over view 

4.3.1.1. Purpose of Interface 

The Discovery Wizard provides the user interface to configure and run Server Consolidation Discovery. 

4.3.1 .2. Functions 

The functions performed by the wizard consist of configuring the discovery command in anyone of five 
different ways optionally setting advanced properties and options that control the discovery execution 
tTomT database u P date - Md ™™ing and/or scheduling the discovery process. (Requirements 

4.3.1. 3. Form 

The Discovery Wizard will have pages to specify the server(s) to run discovery on, to optionally set 
advanced properties and options, and to schedule and/or run the discovery operation. A Back button is 
provided to allow the user to return to any page and make corrections. Each page of the wizard is displayed 
and described in further detail below. uiayiayeu 



ffi Application Asset Manager Disc 




every ^aji^MMgi 



Welcome to the Application Asset Manager 
Discovery Wizard 

The Discovery Wizard will guide you through the steps 
required to run the discovery tool for server consolidation 
provided by the Application Asset Manager. 

To continue, select Next. 



WARNING: This program is protected by copyright laws and 
international treaties. 



Advances to the next page in the Discovery Wizard. 



Exits the Discovery Wizard. 
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Seiver Specification 

Discover process information from one or more servers. 



9 




Server by Host Name 
Servers by Host List 



Servers by TCP/IP Subnet 



Servers by Site Name 



Servers by Domain Name 



Back 



Next 
Cancel 



Selects the wizard page for single server discovery. 



Selects the wizard page for multiple server discovery using a host 
list file. 



Selects the wizard page for multiple server discovery using a 
TCP/IP subnet. & 



Selects the wizard page for multiple server discovery using a Site 
Name. 



Selects the wizard page for multiple server discovery using a 
Domain Name. 



Returns to the Welcome page. 



Advances to the page selected on this page. 



Exits the Discovery Wizard, 
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fi g Application Asset Man ager Discovery Wiza'rdff ^^^SSSSBBSBB^^^ 




Host Name 



Browse 



User Name 

Password 

Back 



Save 



Cancel 



The name of the server to run discovery < 



Displays the Browse for Computer dialog that allows the user to 
select a server from a list of available servers on the network. 



A valid Windows user domain name and user ID on the server. 



The Windo ws login password for the user name on the ser ver. 



Returns to the Server Specification page. 



Saves the discovery command and advances to the Advanced 
Options page. 



Exits the Discovery Wizard. 



UNISYS RESTRICTED CONFIDENTIAL 

C:\WINNTVProfiles\AIemzn Y\Desktop\A AM 1.0 Functional Spec doc 
100 



I 

2 
3 
4 



5 
6 
7 



Title: Application Asset Manager Server Consolidation Features 
Type: Functional Design Specification 
Owner: Jonathan Ziebell 




68763895-003 
Version B 



Field 

Select computer to discover 


Description 

Select desired server from hierarchy of network domains and 
servers. 


OK 
Cancel 


Close the dialog and selects the currently highlighted server. OK is 

only enabled if currently selected item is a server. 

Close the dialog without selecting a server. 
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Hose List Fife 

Discover proocess information for 
new list of host names. 



servers using an existing fist of host names or a 




Held 



Open Host List File 



Browse 



Back 
Next 



C 



Description 



Determines whether to open an existing host list file or create a" 
new host list file. 



If Open Host List File is checked, the user can type the full path 
name of a host list file. F 



I . f °Pf n rtost Ust ™ e « checked, the user can browse for a host 
list file. The selected frie is displayed in the Host List File Box. 



Returns to the Server Specification pa? e. 
Advances to the next page in the * 
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Seivers by Host List 

Discover process information from a I 




t of servers specified in a host list fib. 




Field 


Description 


Host List 


The name of the server to run discovery on 


Add i 


Displays the Add dialog that allows the user to add one or more 
servers to the host list. 


Edit 


Displays the Edit dialog that allows the user to edit the selected 
server items from the host list. If more than one server is selected 
from the host list, only the user ID and password can be modified. 


Remove 


Removes the selected servers from the host list 


Select All 


Selects all the servers in the host list. 


Back 


Returns to the Host List File page. 


Save 


Saves the discovery command and the host list file, then advances 
to the Advanced Options page. 


Cancel 


Exits the Discovery Wizard. 



J 
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Available Host Name s 
Selected Host Names 



Move (») 



Move («) 



OK 
Cancel 



The name of the server to run discovery on. 



Displays a dialog that allows the user to select a server from a list 
of available servers on the network. 



If one or more servers are selected from the Available Host Names 
list, pushing this button moves the selected servers to the Selected 
Host Names list. 



If one or more servers are selected from the Selected Host Names 
list, pushing this button moves the selected servers to the 
Available Host Names list. 



Adds the Selected Host Names to the host list and returns to the 
Servers by Host List page. 



Cancels the Add operation and returns to the Servers by Host List 
page. ^ 
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Field 


Description 


Host Name 


The name of the server to run discovery on. Disabled if more than 
one server was selected from the host list. 


Browse 


Displays a dialog that allows the user to select a server from a list 
of available servers on the network. Disabled if more than one 
server was selected from the host list. 


User Name 


A Valid Windows user domain name and user ID on the server(s). 


Password 


The Windows login password for the user name on the server(s). 


OK 


Modifies the selected server(s) from the host list and returns to the 
Servers by Host List page. 


Cancel 


Cancels the Edit operation and returns to the Servers by Host List 
page. 
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^Ap plicatio n Asset Manager Discover 



y Wizard 
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4 



Q Application Asset Manager" Discover * Wizard; ff| jll^^^^^^^fc^ 



Servers by Site Name 

Discover process formation horn all servers in the same site. 




r, t l T r *■»•_ # *• ... 

[i£s[er. njSiftfe 




Field 



Site Name 



Browse 



Password 



Back 



Save 



Cancel 



Description 



The site name of the servers to run discovery on. 



Displays the Select a Site dialog that allows the user to select a site 



name 



from a list of available site names on the network. 



A valid Windows user domain name and user ID on the servers. 
The Windows login password for the user name on t he servers. 



Returns to the Server Specification page. 



Saves the discovery command and advances to the Advanced 
Options page. 



Exits the Discovery Wizard. 
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1 
2 

3 

4 



5 
6 





'Application Asset Manager Discovery Wizard 



Servers by Domain Name 

Discover process inf ormation from all servers in the same domain. 
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Field ~ ~ 
Domain Name 
Browse ™ 

User Name 
Password 


Description 

The domain name of the servers to run discovery on. 

Displays the Select a Domain dialog that allows the user to select 
a domain name from a list of available domains on the network. 
A valid Windows user domain name and user ID on the servers 


Back 

Save ~— ~_ — ^ 
Cancel 


The Windows login password for the user name on the servers. 
Keturns to the Server Specification page. 
Saves the discovery command and advances to the Advanced 
Options page. 

Exits the Discovery Wizard. 



1 

2 



3 
4 

5 




Field 



Domain to Discover 
OK 



Cancel 



Description 



Select desired domain from list of available domains 



Close the dia log and select the currently highlighted dom ain. 



Close the dialog without selecting a domain 
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@ Application Asset Manager. Discovery Wiz 



Advanced Options 

Modify the discovery exection sequence, change discovery options, ot schedule 
the discovery to run at a later time. . 




Options 



Field 



Properties 



Schedule 



Back 



Next 



Cancel 



Description 



Displays the Discovery page in the Properties dialog box. 



Displays the Discover dialog box 



Displays the Task Scheduler dialog box. 



Returns to the previous page 



Advances to the next page in the Discovery Wizard, 



Exits the Discovery Wizard 
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Tasks 



Close 
Add 



Delete 
Run 



End Task 
Properties 



Rename 



Help 




The list of discovery and deployment tasks currently scheduled. 



Closes this dialog box. 



Creates a new task and displays "New Task" in the task list. An 
edit box is enabled to allow the user to change the name of the 
task. 



Removes the selected task from the schedule. 



Executes the selected task. 



Aborts the selected task. 



Displays the Properties dialog. 



Enables an edit box for the selected task. 
Displays help for this dialog. 
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This is the Properties dialog box that is displayed when the properties item is selected from the context 
menu or the user chooses the properties button. The three pages on this dialog are taken directly from 
Microsoft's Task scheduler so no further documentation will be provided in this specification. The 
Schedule and Settings pages are displayed below. 
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v!3 Application Asset Manager D 



Field 



Back 
Run 



Close 



Application Asset Manager Discovery Wizard 
Completed 



Setect Run to exit the Discover Wizard and run discovery. 

Select Close to exit the Configuration Wizard without tunning 
discovery. 




Description 



Returns to the Advanced Options page. 



Exits the D iscovery Wizard and runs the discovery command. 



Exits the Discovery Wizard 
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4.4. Discovery Properties ; 

4.4.1 .1 .Purpose of Interface 

The Discovery page in the Properties dialog box provides the user interface for viewing and modifying the 
discovery execution sequence. 

4.4.1. 2-Functions ' 

The functions available on the dialog consist of "Move Item Up", "Move Item Down", "Add", "Edit", 
"Remove", "OK", "Cancel", and "Help". These functions are described in the table below the image of the 
Discovery page. (Requirements T101 1) 

4.4.1 .3. Form 



The Discovery page in the Properties dialog box will have a list control to display the execution sequence, 
buttons to add, edit, or remove applications in the execution sequence, and edit boxes to display the 
currently selected application in the execution sequence. The Add and Edit buttons, when selected, will 
dispJay an Add Application dialog box and an Edit Application dialog box. The Discovery page, Add 
Application dialog box, and Edit Application dialog box are displayed and described in further detail 
below. 
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>r ». - ■ 



0 



Continue 



Stop 






Execution Sequence 



Up Arrow Button 



Description 



The list of application that will be executed during discovery. A 
label represents each application in the execution sequence. 
Selecting a label displays the details about the application in the 
Application group box. The execution sequence also displays the 
exit codes that indicate the application ran successfully and the 
labels that indicate what to do if the application passes or fails. 
The permitted labels are Continue, Repeat, Stop, or an application 
label for another application in the execution sequence. 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 

• Application Label: Runs the application with the designated 
label. 



Moves th e selected application up one in the execution sequence. 
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Down Arrow Button 


Moves the selected application down one in the execution 
sequence. | 


Add 


Displays the Add Application dialog box. The execution sequence 
is updated upon return from the Add Application dialog box. The 
new application, if any, is added to the end of the execution 
sequence. 


Edit 

Remove ~ 


±s*oyiayst uic j^uii application dialog dox and initializes the dialog 
box with the selected application in the execution sequence. The 
execution sequence is updated upon return from the Edit 
Application dialog box. 


Application Path Name 


Removes the selected application from the execution sequence. 
The full path name of the selected application in the execution 


Application Parameters j 


The parameters for the selected application in the execution * 
sequence. 


Application Description 
Description 


The description of the selected application in the execution 
sequence. 


OK 


The description of the execution sequence. 

Save the execution sequence in the database and exits the 

Properties dialog box. 


Cancel 
Help 


Exits the Properties dialog box without saving the execution | 
sequence. 

Provides online help for the Discovery page. ! 
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Path Name 



Browse 



Parameters 



Description 

Result Handler Pass Codes 



Result Handler On Pass 



The label that represents the application. 



The full path name of the application 



Displays a dialog box that allows the user to browse for an 

application. The Path Name box is updated with the specified file 
if any 



The parameters for this application. The parameters can include 
macro names that are expanded to their value at the time the 
application is executed. The following macros are permitted: 

• _applicationName_: The full path name of the application. 

• fileNames_: The list of files copied to the destination 
directory before discovery. 

• . _workingPath_: The source and destination for discovery. 

• _exitCode_: The exit code of the application executed just 
prior to this application. 



The description for this application. 



A comma separated list of integer values that represent all the exit 
codes that can be returned by this application to indicate success. 
The list may include ranges with the bounds of a range are joined 
by two decimal points (".."). 



A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
theapphcation passed. The dropdown list contains the following 
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• Other application labels: Runs the application with the 
designated label. 


Result Handler On Fail 


A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
the application failed. The dropdown list contains the following 
labels: 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 

• Other application labels: Runs the application with the 
designated label. 


OK 

Cancel 
Help 


Exits the dialog box and updates the application in the execution 
sequence. 

Exits the dialog box without updating the application. 
Provides online help for this dialog box. 



s 
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Field 


Description 


Label 


The label that represents the application. 


Path Name 


The full path name of the application. 


Browse 


Displays a dialog box that allows the user to browse for an 
application. The Path Name box is updated with the specified file, 
if any. 


Parameters 


The parameters for this application. The parameters can include 
macro names that are expanded to their value at the time the 
application is executed. The following macros are permitted: 

• applicationName_: The full path name of the application. 

• fileNames : The list of files copied to the destination 

directory before discovery. 

• _workingPath_: The source and destination for discovery. 

• exitCode : The exit code of the application executed just 

prior to this application. 


Description 


The description for this application. 


Result Handler Pass Codes 


A comma separated list of integer values that represent all the exit 
codes that can be returned by this application to indicate success. 
The list may include ranges with the bounds of a range are joined 
by two decimal points (".."). 


Result Handler On Pass 


A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
the application passed. The dropdown list contains the following 
labels: 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 
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• Other application labels: Runs the application with the 
) designated label. 


Result Handler On Fail 


A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
the application failed. The dropdown list contains the following 
labels: 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 

• Other application labels: Runs the application with the 
designated label. 


OK 


Exits the dialog box and appends the application to the end of the 
execution sequence. The OK button is enabled when the Label, 
Path Name, and Result Handler boxes all contain non-empty 
values. 


Cancel 


Exits the dialog box without updating the application. 


Help 


Provides online help for this dialog box. 
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1 4.5. Analysis Properties 

2 4.5.1.1. Purpose of Interface 

3 The Analysis page in the Properties dialog box provides the user interface for viewing and modifying the 

4 analysis execution sequence. 

: 

5 4.5.1 .2.Functions 

6 The functions available on the dialog consist of "Move Item Up", "Move Item Down" "Add", "Edit", 

7 "Remove", "OK", "Cancel",. and "Help". These functions are described in the table below the image of the 

8 Analysis page. (Requirements T101 1, T1217) 

9 4.5.1. 3.Form 

1° The Analysis page in the Properties dialog box will have a list control to display the execution sequence, 

1 1 buttons to add, edit, or remove applications in the execution sequence, and edit boxes to display the 

12 currently selected application in the execution sequence. The Add and Edit buttons, when selected, will 

13 display an Add Application dialog box and an Edit Application dialog box. The Analysis page, Add 
*4 Application dialog box, and Edit Application dialog box are displayed and described in further detail 
15 below. 



i 
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Execution Sequence 



Up Arrow Button 



The list of application that will be executed during analysis. A 
label represents each application in the execution sequence. 
Selecting a label displays the details about the application in the 
Application group box. The execution sequence also displays the 
exit codes that indicate the application ran successfully and the 
labels that indicate what to do if the application passes or fails. 
The permitted labels are Continue, Repeat, Stop, or an application 
label for another application in the execution sequence. 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 

• Application Label: Runs the application with°the designated 
label. c» 



Moves the selected application up one in the execution sequence. 
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Down Arrow Button 


Moves the selected application down one in the execution 
sequence. 


Add 


Displays the Add Application dialog box. The execution sequence 
is updated upon return from the Add Application dialog box. The 
new application, if any, is added to the end of the execution 
sequence. 


Edit 
Remove 


Displays the Edit Application dialog box and initialireQ th*» Hiai^o 
box with the selected application in the execution sequence. The 
execution sequence is updated upon return from the Edit 
Application dialog box. 


Application Path Name 


Removes the selected application from the D 

The full path name of the selected application in the execution 

sequence. 


Application Parameters 


The parameters for the selected application in the execution 
sequence. 


Application Description 
Description 


The description of the selected application in the execution 
sequence. 


OK 


The description of the execution sequence. 

Save the execution sequence in the database and exits the 

Properties dialog box. 


Cancel 
Help 


Exits the Properties dialog box without saving the execution 
sequence. 

Provides online help for the Analysis page. 
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Label 



Path Name 



Browse 



Parameters 



Description 



Result Handler Pass Codes 



Result Handler On Pass 



The label that represents the application. 
The full path name of the application. 



Displays a dialog box that allows the user to browse for an 
application. The Path Name box is updated with the specified file, 
if any. 



The parameters for this application. The parameters can include 
macro names that are expanded to their value at the time the 
application is executed The following macros are permitted: 

• — applicationName_: The full path name of the application. 

• _fileNames : The list of files copied to the destination 

directory before analysis. 

• — workingPath_: The source and destination for analysis. 

• — exitCode : The exit code of the application executed just 

prior to this application. 



The description for this application. 



A comma separated list of integer values that represent all the exit 
codes that can be returned by this application to indicate success. 
The list may include ranges with the bounds of a range are joined 
by two decimal points (".."). 



A label designating the place in the execution sequence to jump to 
after exiling from this application with an exit code that indicates 
the application passed. The dropdown list contains the following 
labels: 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 
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• Other application labels: Runs the application with the 
designated label. 


Result Handler On Fail 


A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
the application failed. The dropdown list contains the following 
labels: 

• Continue: Runs the next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 

• Other application labels: Runs the application with the 
designated label. 


OK 


Exits the dialog box and updates the application in the execution 
sequence. 


Cancel 


Exits the dialog box without updating the application. 


Help 


Provides online help for this dialog box. 



I 
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Add Application 




Browse 



Parameters 



Description 



Displays a dialog box that allows the user to browse for an 
application. The Path Name box is updated with the specified file 
if any. 



The parameters for this application. The parameters can include 
macro names that are expanded to then* value at the time the 
application is executed. The following macros are permitted: 

• _applicationName_: The full path name of the application. 

• _fileNames_: The list of files copied to the destination 
directory before analysis. 

• _workingPath — : The source and destination for analysis. 

• _exitCode_: The exit code of the application executed just 
prior to this application. 



Result Handler Pass Codes 



Result Handler On Pass 



The description for this application. 



A comma separated list of integer values that represent all the exit 
codes that can be returned by this application to indicate success. 
The list may include ranges with the bounds of a range are joined 
by two decimal points ("."). 



A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
the application passed. The dropdown list contains the following 
labels: 

• Continue: Runs the nexl application in the sequence. 

• Repeat: Reruns the current application in the sequence. 
Stop: Aborts the execution sequence. 
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• Other application labels: Runs the application with the 
designated label. 


Result Handier On Fail 


A label designating the place in the execution sequence to jump to 
after exiting from this application with an exit code that indicates 
the application failed. The dropdown list contains the following 
labels: 

4h lwWlMl%Blil» Dime* fr- It <Tk • MM *<! A M Zm**. M. — - - - 

• conunue. Kuns cne next application in the sequence. 

• Repeat: Reruns the current application in the sequence. 

• Stop: Aborts the execution sequence. 

• Other application labels: Runs the application with the 
designated label. 


OK 


Exits the dialog box and appends the application to the end of the 
execution sequence. The OK button is enabled when the Label, 
Path Name, and Result Handler boxes all contain non-empty 
values. 


Cancel 


Exits the dialog box without updating the application. 


Help 


Provides online help for this dialog box. 
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1 4.6. Discover Dialog 

2 4.6.1. Overview 



4.6.1 .1 .Purpose of Interface 

The Discover Dialog Box provides the user interface for performing the Discover operation including 
selection of which projects are to be discovered as well as setting various discover options. 

4.6.1 .2.Functions 

The functions available on the dialog consist of standard 'OK% "Cancel", "Select Air, and "Help" buttons 
where "OK" will perform the discovery using the settings from the tab control described below. "Cancel" 
. will cancel the operation and "Select All" highlights all items in the "Items to be discovered" list "Help" 
will bring up the Application Asset manager Help window for Discover. There will also be a "Schedule" 
button that will allow the user to schedule discovery. (Requirements T1054, T1219) 

4.6.1 .3-Form 

The Discover Dialog Box will have similar size and the same general look as the Checkout or Checkin 
dialogs. That ts. it will consist of a listview at the top-left with function buttons at the top-right and various 
controls for operation settings below. The listview contains all applicable items that were selected when 
the user chose the 'Discover" menu command. Initially all items will be checked but individual items may 
be checked or unchecked to indicate whether they should be discovered. Only checked items will be 
discovered. The Discover Dialog will contain a tabbed control with up to four tabbed pages. Each page 
contains options related to a specific aspect of the Discover operation and are described in further detail 
below. 
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Items to Discover 
Select All 



Get Files Before Discovery 
Schedule — — — 



Tabbed Control 



Description 



The list of items to discover. 



Highlight each item in the list box. 
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If checked, files will be retrieved from the database 
before the discovery process sequence is run. 



When clicked, the Task Scheduler Dialog will be 
displayed allowing the user to schedule discovery for- 
one or more times in the future. 



Provides controls for various Discover settings- Each tab 
is described in more detail below. 



4.6.1.3.1. Source Tab 

The Source tab provides controls for setting the source path for the Server Consolidation Project. 

ut O l ^SSS£SS^'f^ T ? '¥ ^ 3 CheCkCd ° Ut " ath "W- «° them, then the 

T 1 S ° UrCe F ° ,der field and B ™ wse bu «on will be 

root t SSelS 3?3SS \ i J Y CheCkCd ° Ut Path if there is ° n, >' <> ne item ° r W co ~ 
r00t *" ldcr of ail Checked out P ath * ' f there »s more than one item in the list. If one or more items in the list 
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do not have a checked out path assigned, then the Use Checked Out Path checkbox will be unchecked the 
Source Folder field and Browse button will be enabled, and the user will be required to specify a Source 
Folder. J 




Use Checked Out Path 



Source Folder 



Browse 



Description 



Whether or not to use the checked out path as the source folder. 
The Source folder and Browse button are disabled when Use 

Checked Out Path is checked. 

Specifies the folder to discover files from. 



When clicked, a Select Source Folder dialog displays to select the 
source folder. 
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4.6.1.3.2. Discovery Tab 



The Discovery tab provides controls for settings that determine the state of files discovered after the 
SSK S J3T C l I T T^ 6 corres P° ndin 8 stored in the AAM. Initially, the Make Reaa-Only 
checkbox will be checked and all other checkboxes will be unchecked. The Comment field wfll bTempty 



Discover 




Field 



Discover Subfolders 



Keep Checked Out 
Force Checkin 



Comment 



Remove Local Copy 
Make Read-Only 



Description 



Whether to update database with files from subfolders of 
the source folder. 



Whether to check out again after checking in. 



Whether to force checkin even if no changes have been 
made. 



Description of revision being checked in or added. 



Whether to remove the local item from the file system. 
Whether to make the local file read-only. 
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4.6.1.3.3. New File Discovery Tab 



The New File Discovery tab provides controls for settings that determine the state of any new files being 
created in the database during Discovery. Initially the Use Extension Defaults checkbox will be checked 
and all other controls will be disabled. If the Use Extension Defaults checkbox is unchecked then the other 
controls will be enabled. 
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Field 


Description 


Use Extension Defaults 


Whether to use the default options. 


Expand Keywords 


Whether to expand keywords embedded in the file contents. 


Start Comment Delimiter 


Beginning of comment in keyword expansions. 


End Comment Delimiter 


Ending of comment in keyword expansions. 


File Type 


Choice of Auto-Detect, Text, or Binary. 


Store Latest Version Only 


Whether to store only the latest version of the file in the database, 
after each checkin. 


Store Externally 


Whether to store the file contents in the file system, rather than in 
the database. 


Store Compressed 

1 


Whether or not to store the contents of each added file in a 
compressed format. The file will be decompressed when retrieved 
from the database. 


Require Exclusive Checkout 


Whether only one person at a time can check out the file. 
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4 
5 
6 



i 

7 



4.6.1 .3.4. Get Options Tab 

The Get Options tab provides controls for settings that determine which objects are retrieved from the 
database. It will only be available if the "Get Files Before Discovery" checkbox is checked. Initially, the 
Get Changed Only checkbox will be checked and ail other checkboxes will be unchecked. The Get Files 
Labeled With field will be disabled unless the user checks the Get Files With label checkbox. The Replace 
Writable dropdown list will be set to Ask, and the Set Timestamp dropdown list will be set to Current. 




Field 



Get subcontainers . 



Make Writable 



Get Changed Only 



Get Files Labeled With 



Replace Writable 



Set Timestamp 



Description 



For each item listed, whether or not to get it's subcontainers. 



Whether to make copies in file system writable. 



Whether to get only items that have changed relative to copies in file 
system. 



If a label is entered, the version of items with the given label will be 
obtained. 



If writable copies of the items are already in the fileosystem, 
determines the course of action. Choices are Ask, Replace, Skip. 



How to set the timestamp of the copy in the file system. Choice of 
Current, Modification, or Checkin. . 
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4.6.2. User Manual 

When a user invokes the "Discover" command on one or more Server Consolidation Projects the Discover 
Dialog Box is displayed. A user may then select which Server Consolidation Projects to Discover in the 
Sterns to be discovered" list. A user may navigate the various pages of the tabbed control by clicking on an 
individual tab. After selecting the desired options for the discover operation, or accepting default values, a 
user can choose "OK" to perform the Discover or "Cancel" to cancel the operation. 
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2 4.7. Analyze Dialog 

3 4.7.1. Overview 

4 4.7.1 .1 .Purpose of Interface 

5 The Analyze Dialog Box provides the user interface for performing Analyze operation including selection 

6 of which projects are to be analyzed as well as setting various analysis options. 

7 4.7.1 .2. Functions 

8 The functions available on the dialog consist of standard 4 OK\ "Cancel", "Select All" and "Help" buttons 

9 where "OK" wiir analyze the project using the settings from the tab control described below. "Cancel" will 

10 cancel the operation and "Select Air highlights all items in the "Items to be analyzed" list "Help" will 

1 1 . bring up the Application Asset manager Help window for Analyze. There will also be a "Schedule" button 

12 that will allow the user to schedule analysis. (Requirements T1055, T1219) 

13 4.7.1 ,3.Form 

14 The Analyze Dialog Box will have similar size and the same general look as the Checkout or Checldn 

15 dialogs. That is, it will consist of a listview at the top-left with function buttons at the top-right and various 

16 controls for operation settings below. The listview contains all applicable items that were selected when 

17 the user chose the "Analyze" menu command. Initially all items will be checked but individual items may 

18 be checked or unchecked to indicate whether they should be deployed. Only checked items will be 

19 analyzed. The Analyze Dialog will contain a tabbed control with four tabbed pages. Each page contains 

20 options related to a specific aspect of the Analyze operation and are described in further detail below. 
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Field 



Items to Analyze 



Select All 



Update Files After Analysis 
Schedule — — _ 



Tabbed Control 



Description 



The list of items to analyze. 



Highlight each item in the list box. 
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If checked, files will be updated in the database after 
the analysis process sequence is run. 



When clicked, the Task Scheduler Dialog will be 
displayed allowing the user to schedule analysis for 
one or more times in the future. 



Provides controls for various Analysis settings. Each 
tab is described in more detail below. • 



4.7.1. 3.1. Destination Tab 

The Destination tab provides controls for setting the destination path for the Server Consolidation Project. 
Initially, if all Server Consolidation Projects in the list have a working path assigned to them, then the Use 

u!"} checkbox win be checked and the Destination Folder field and Browse button will be 
disabled. The Destination Folder field will display the Server Consolidation Project working path if there is 
only one item or any common root folder of all working paths if there are more than one item in t he list. If 
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one or more items in the list do not have a working path assigned, then the Use Working Path checkbox 
will be unchecked, the Destination Folder field and Browse button will be enabled, and the user will be 
required to specify a Destination Folder. 
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Field 


Description 


Use Working Path 


Whether or not to use the project working path as the project 
destination folder. The Destination folder and Browse button are 
disabled when Use Working Path is checked. 


Destination Folder 


Specifies the folder to get project files into. 


Browse 


When clicked, a Select Destination Folder dialog displays to select the 
project destination folder. 



UNIJ^E5®teg^RJ€'TED CONFIDENTIAL 

C:\WINNTVProfiies\Alem2aYU)cskiop\AAM 1.0 Functional Spec.doc 
141 



1 

2 



4 
5 
6 
7 



Title: Application Asset Manager Server Consolidation Features 
Type: Functional Design Specification 
Owner: Jonathan Ziebell 



68763895-003 
Version B 



4.7.1 .3.2. Analysis Tab 

The Analysis provides controls for settings that determine which objects are retrieved from the database. 

XfS?' ^^!%¥? ^ n, ^ heckbox wi » ^ checked and all other checkboxes will be unchecked. The 
Get Files Labeled W,tli .field will be disabled unless the user checks the Get Files With label ch4bS The 
Replace Wntable dropdown list will be set to Ask, and the Set Timestamp dropdown list will be seUo 
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Description 



Get subcontainers 



For each item listed, whether or not to get it's 
subcontainers. 



Make Writable 
Get Changed Only 



Whether to make copies in file system writable. 



Whether to get only items that have changed relative to 
copies in file system. 



Get Files Labeled With 
Replace Writable 



If a label is entered, the version of items with the given 
label will be obtained. 



Set Timestamp 



If writable copies of the items are already in the file 
system, determines the course of action. Choices are Ask, 
Replace, Skip. 



How to set the timestamp of the copy in the file system. 
Choice of Current, Modification, or Checkin. 



4.7.1 .3.3.Checkin Options Tab 

The Checkin Options tab provides controls for settings that determine the state of Files after the analyze 
sequence has run and the corresponding tiles stored in the AAM. This tab will only be available if the 
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"Update Files After Analysis" checkbox is checked. Initially, the Make Read-Only checkbox will be 
checked and all other checkboxes will be unchecked. The Comment field will be empt^ 



Analyze 




Field 



Discover Subfolders 



Keep Checked Out 



Force Chec kin 
Comment 



Remove Local Copy 
Make Read-Only 



Description 



Whether to update database with files from subfolders of the 
destination folder. 



Whether to check out again after checking in. 



Whether to force checkin even if no changes have been made. 



Description of revision being checked in or added. 



Whether to remove the local item from the file system. 



Whether to make the local file read-only. 



4.7.1. 3.4. Add Options Tab 

Jhc£?l?£ l A™ ta ^ prov i des controls for stings that determine the state of any new files being created in 
the database during the update after analysis. This tab will only be available if the "Update Files After 

5SS n r " CheCl f d ° n thC dia, ° g - InitiaU ' the Use Extensio « Etefculf checkbo be 
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Expand Keywords 



Start Comment Delimiter 
End Comment Delimiter 



File Type 

Store Latest Version Only 



Store Externally 



Store Compressed 



Require Exclusive Checkout 



Whether to use the default options, 
Whether to expand keywords embedded in the file 
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Beginning of comment in keyword expansions. 



Ending of comment in keyword expansions. 
Choice of Auto-Detect, Text, or Binary, 



Whether to store only the latest version of the file in the database 
after each checkin. 



Whether to store the file contents in the file system, rather than in 
the database. 



Whether or not to store the contents of each added file in a 
compressed format. The file will be decompressed when retrieved 
from the database. 



Whether only one person at a time can check out the file. 
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1 4.7.2. User Manual 

2 When a user invokes the "Analyze" command on one or more Server Consolidation Projects the Analyze 

3 Dialog Box is displayed. A user may then select which Server Consolidation Projects to analyze in the 

4 "Items to be analyzed" list. A user may navigate the various pages of the tab control by clicking on an 

5 individual tab. After selecting the desired options for the analyze operation, or accepting default values, a 

6 user can choose "OK" to perform the Analyze or "Cancel" to cancel the operation. 

7 4.8. AAM Discovery Tool 

8 4.8.1. Overview 

9 4.8.1.1. Purpose of Interface 

10 The AAM Discdvery tool (AAMDiscover.exe) is a command line executable to run and schedule discovery 

1 1 operations once the options have been selected within AAM. (Requirements T10I5) 

12 4.8.2. User Manual 

1 3 The following is the command line interface when invoking AAMDiscover.exe: 

14 usage: 

15 AAMDiscover.exe [options] path [{path}] 

16 options: 

17 [General | Get Options | Discovery | New File Discovery] 

18 path: 

19 Database path of item(s) to discover. 

20 General: 

21 -? Help, displays this text. 

22 -d <database name> The name of the database to open. Default: None 

23 -get Enable get options. Default: False 

24 -i <user id> The login id for this user. Default: None 

25 -t Trace to log file. Default: False 

26 -q Quiet (Suppress all output). Default False 

27 -z <password>- The password for this user. Default: None 

28 . Get Options: 

29 -ch * Get changed subcontai ners only. Default: All 

30 -L <!abel> Get items with version label, <Iabel>. Default: Null 

3 * -p <path> Get destination folder. Default: Working path 

32 -rep Replace writable items. Default: Skip 

33 -sub Get subcontainers. Default: False 

34 -time ICurrent | Modified | Checkin] 
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1 

1 


- 


Set items timestamp. 


Default: Current 


1 


-w 


Make writable. 


Default: Read only 


3 


Discovery: 






4 


-c <string> 


Comment to add to database. 


Default: 


5 


~K 


Keep database item checked out. 


Default: False 


6 


-force 


Force database item Checkin. 


Default: False 


7 


-rem 


Remove local file copy. 


Default: False 


o 

8 


-read 


Make local file read only. 


Default: False 


9 


» New File Discovery: 






10 


-cStartDe! <string> 


Starting comment delimiter(s). 


Default: nn 


11 


-cEndDel <string> 


Ending comment delimiter(s). 


Default: 


12 


-compress 


Store the file compressed. 


Default: False 


13 


-exclusive 


. Set exclusive checkout. 


Default: False 


f A 

14 


-extensions 


Set new file extensions attributes. 


Default: Database 


15 


-external 


Store the file external to the database. 


Default: False 




-expand 


Expand file key words. 


Default: False 


17 


-fileType [AutoDetect | Binary | Text] 




18 




File storage type in database. 


Default: AutoDetect 


io 
iy 


-latestVer 


Store the latest version of the file only. Default: False 


20 


4.9. AAM Deployment Tool 




21 


4.9.1. Overview 






22 


4.9.1.1 .Purpose of Interface 







23 
24 

25 

26 
27 
28 
29 
30 
31 
32 
33 



The AAM Deployment tool (AAMDeploy.exe) is a command line executable to run and schedule 
deployment operations after the options have been selected within AAM. (Requirements T1014) 

4.9.2. User Manual 

usage: 

AAMDeploy.exe [options] path [{path } 1 
options: 

I General | Deploy | Checkin Options | Add Options] 
path: 

Database path of item(s) to deploy. 
General 

-f Help, displays this text. 
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1 


-d <database name> 


The name of the database to open. 


Default: None 


2 


-i <user id> 


The login id for this user. 


Default: None 


3 


-t 


Trace to log file. 


Default: False 


4 




Quiet (Suppress all output). 


Default: False 


5 


• 

-update 


Enable update (Checkin and Add) 


Default: False 


6 


-z <password> 


The password for this user. 


Default: None 


7 


Deploy Options 






8 


-c.h 


Get changed subcontainers only. 


Default: All 


9 


-L <label> 


Get items with version label, <label>. 


Default: Null 


10 


-p <path> 


Get destination folder. 


Default: Working path 


11 


-rep 


Replace writable items. 


Default: Skip 


12 


-sub 


Get subcontainers. 


Default: False 


13 


-ti me [Current [ Modified | Checkin] 




14 




Set items timestamp. 


Default: Current 


15 


-w 


Make writable. 


Default: Read only 


16 


Checkin Options: 






17 


-c <string> 


Comment to add to database. 


Default: 


18 


-k 


Keep database item checked out. 


Default: False 


19 


-force 


Force database item Checkin. 


Default: False 


20 


-rem 


Remove local file copy. 


Default: False 


21 


-read 


Make local file read only. 


Default: False 


22 


Add Options: 






23 


-cStartDel <string> 


Starting comment delimiters). 


Default: 


24 


-cEndDel <string> 


Ending comment delimiter(s). 


Default: M " 


25 


-compress 


Store the file compressed. 


Default: False 


26 


-exclusive 


Set exclusive checkout. 


Default: False 


27 


-extensions 


Set new file extensions attributes. 


Default: Database 


28 


-external 


Store the file external to the database. 


Default: False 


29 


-expand 


Expand file key words. 


Default: False 


30 


-fileType [AutoDetect | Binary | Text] 




31 




File storage type in database. 


Default: AutoDetect 


32 


- latest Ver 


Store the latest version of the file only. 


Default: False 


33 









o 
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Appendix A: Requirements 



Requirements 



T840: Simplify AAM 
configuration 
Simplify AAM 
configuration by 
making as many tasks 
as possible more 
programmatic (for 
example, consider 
tasks related to FTP, 
Terminal Services, and 
privileges). 



T1007: Generate the 
universe configuration 
file from the wizard 
AAM Configuration 
Wizard. Generate the 
Griffin universe 
configuration file from 
the wizard. Additional 
pages will be added to 
the wizard to collect 
audit and data partition 
count, size, and 
jocation information. 
T1 008: Report a 
warning instead of an 
error if FTP is not 
installed 

The AAM Configuration 
Wizard will report a 
warning instead of an 
error if FTP is not 
installed, 



T1009: Support for 
Server Consolidation 
folders. 

AAM Shell. A Server 
Consolidation folder 
extension with server 
consolidation discovery 
and deployment tags 
will be added to the 
AAM.xmlfile. This file 
is used to populate the 
database with file and 
folder extensions at 
database creation time. 
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Requirements 



T1 010: Add Server 
Consolidation folder to 
the Fife/New menu 
AAM Shell in addition 
to the Server 
Consolidation menu 
item on the AAM Shell 
menu bar, if the Server 
Consolidation folder 
extension is registered 
on the current folder, a 
Server Consolidation 
folder item will be 
added to the File/New 
submenu and the New 
submenu in the AAM 
Shell list view context 
context menu. 



Prod 
Engr Mgr 



Lefebvre 



Dvlpm 
nt Mgr 
f1- 
Flt:Y 
Srt:N 
Stefani 
ak, J 



11: New dialogs for 
Add/Modify properties 
of Analysis and 
Discovery 

AAM Shell. For Server 
Consolidation folders, 
the Analysis(Deploy) 
and Discovery property 
pages will be modified 
to move the application 
path name, 
parameters, etc. to a 
new dialog that is 
displayed when the 
Add or Modify button is 
pushed on the Analysis 
or Discovery property 
page. The new diafog 
for Add and Modify 
from the Discovery 
property page will have 
a button to start the 
j Server Consolidation 
wizard. 
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1 Requirements 1 
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Statu I 
s 


Priorit 

y 


RDP 

Ref.# 


Plann ' 
ed 
Rel 
Lvl 


Tra 
ced 
-to 


I T1014; Add a "smart 0 I 
I command line j 
I application for I 
I Deployment, j 

AAM Deploy. Write a J 
I command line I 
I application called ! 
I "AAMDeploy.exe" that J 
I will copy files from a j 
1 folder in an AAM J 
j database, and then J 
j execute a sequence of 1 
1 commands read from a 1 

file- 1 


P 
D 
L 


Lefebvre I 
,C 


Stefani 
ak, J 


Platform I 
Software j 


Functio 
nality 


Accep I 
ted 


Mediu 
m 


buoU 
10 


1 i 




T1015: Adda "smart 0 
j command line I 
J application for 
I Discovery j 

AAM Discovery. Write 
j a command line 
I application called 
J "AAMDiscover.exe" 
j that will execute a 
I sequence of 
I commands read from a 
I file, and then update a 
I folder in an AAM 
I database and executes 
I a sequence of 
( commands read from a 

file. 


P 
D 
L 


Lefebvre I 
,C 


Stefani 
ak f J 


Platform 
Software I 


Functio 
nality 


Accep ( 
ted 


Mediu 
m 


5030 
10 


1.1 




I T1049: Add a Server 
| Consolidation menu 
J item to the AAM Shell 
I If the Server 
I Consolidation folder 
I extension is registered 
j on the current folder, a 
I Server Consolidation 
I menu item will be 

displayed on the AAM 

Shell menu bar. The 
j Server Consolidation 

menu item will display 
I a dropdown containing 
j New Folder, Discovery, 

Analysis, and Help 
I items. The Discovery 

and Analysis options 
I are only enabled when 

a Server Consolidation 

folder is selected in the 
I AAM Shell. 


P 

I D 
L 


Lefebvre 

.c 


J Stefani 
ak.J 


Platform 
Software 


| Functio 
| nality 


Accep 
ted 


Mediu 
I m 


5030 
10 


1.1 





\ 



UNISYS RESTRICTED CONFIDENTIAL 

C:\WlNNTVPronics\AlcmzaY\Desktop\AAM 1.0 Functional Spcc.doc 
151 



Title: 


Application Asset Manager Server Consolidation Features 


68763895-003 
Version B 


Type: 


Functional Design Specification 


Owner: 


Jonathan Ziebell 





Requirements 


im 

Pl 
Or 

9 


Prod I 
EngrMgr 


Dvfpm 1 
ntMgr 

[1- 

FU:Y 

Srt:N] 


Product 
Area [2 - 
Flf.Y 
Srt:N] 


Catego I 
ry 


Statu 

s 


Priori! I 

y l 


RDP 
Ref.# 


Plann 
ed - 
Rel 
Lvl 


Tra . 

ced 

-to 


T1050: Add menu item 
for Server 
Consolidation 
/Discovery 
AAM Shell. Selecting 
the Server 
Consolidation 
/Discovery menu item 
in the AAM Shell will 
bring up another 
submenu containing 
items to Configure 
discovery and Run 
discovery. 


P 
D 
L 


Lefebvre 1 

.c 


Stefani I 
ak, J 


Platform 
Software 


Functio I 
nality I 


Accep 
ted 


Mediu | 
m J 


5030 
10 


•4 4 
I- 1 




T1051: Implement a 
Server Consolidation 
configuration wizard 
Selecting the Server 
Consolidation 
/Discovery /Configure 
submenu item will start 
up the Server 
Consolidation wizard. 
The Server 
Consolidation wizard 
will contain pages that • 
collect information 
needed to build the 
psexec command line 
required for Server 
Consolidation. 


P 
D 
L 


Lefebvre 1 

,c 


Stefani | 
ak,J 


Platform 
Software 


Functio 
nality 


Accep 
ted 


Mediu 
m 


5030 
10 


1.1 




T1052: Implement 
Server Consolidation 
/New Folder 
Server Consolidation 
/Mew Folder menu item 
will be implemented. 
When selected mis 
item will create an 
Server Consolidation 
Folder in the current 
folder. 


P 
D 
L 


Lefebvre 

,c 


) Stefani 
ak,J 


Platform 
I Software 


Functio 
nality 


I Accep 
ted 


Mediu 
m 


5030 
10 


1.1 




T1053: Implement 
Server Consolidation 
Help 

AAM Shell. Selecting 
the Server 
Consolidation /Help 
menu item will bring up 
help text relative to 
Server Consolidation. 


P 
D 
L 


Lefebvre 
.C 


Stefani 
ak,J 


J Platform 
J Software 


Functio 
nality 


I Accep 
ted 


Mediu 
m 


5030 
10 


1.1 





UNISYS RE»QrreTE©^ONFIDENTiAL r". 

C:\WINNTVProrites\AtemzaYU5esktop\AAM 1.0 Functional Spec.doc 
152 



Title: Application Asset Manager Server Consolidation Features 
Type: Functional Design Specification 
Owner: Jonathan Ziebell 



68763895-003 
Version B 



Requirements 


tm 

Pi 
Or 
i-i 
9 


Prod 
Engr Mgr 


Dvlpm 
ntMgr 
[1- 

Mt.Y 

Srt:N] 


Product 
Area [2 - 
Flt:Y 
brt.NJ 


Catego 
ry 


Statu 

s 


Priorit 

y 


RDP 

Ref.# 


Plann 
ed 
Rel 
Lvl 


Tra 
ced 
-to 


T1054: Implement an 
AAM Shell 

Discovery/Run dialog 
AAM Shell. Selecting 
the Server 
Consolidation 
/Discovery/Run 
submenu item in the 

AAM Shell will hrinn nn 

nni»i *Ji icii will Ullliy IJLJ 

a Server Consolidation 
Discover dialog. 


P 
D 
L 


Lefebvre 
,C 


Stefani 
ak, J 


Platform 
Software 


Functio 
nalily 


Accep 
ted 


Mediu 
m 


5030 
10 


1.1 




T1055: Implement 
Analyze dialog for 
Server Consolidation 
AAM Shell. Selecting 
the Server 

Consolidation /Analysis 
menu item in the AAM 
Shell will bring up the 
Analyze (Deploy) 
dialog. 


P 
D 
L 


Lefebvre 
.C 


Stefani 
ak, J 


Platform 
Software 


Functio 
nalily 


Accep 
ted 


Mediu 
m 


5030 
10 


1.1 




Analysis Tool to 
Windows standard 
features 
Update the AAM 
Analysis Tool to feature 
Window standard 
features such as: 

IrUlUlf ill licdUVl oUII, 

browse feature, 
CTRL/SHIFT for 
multiple item select, 
etc. 


o 
r 

D 
L 


Lefebvre 

.c 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Partia 
1 

Accep 
t 


Mediu 
m 


5030 
10 


1.1 




T1215: Unique file 
extension for analysis 
files 

The input data files for 
Analysis.exe must have 
a unique extension that 
is recognized by the 
Shell and Analysis.exe 


P 
D 
L 


Lefebvre 

,c 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Partia 

Accep 
t 


Mediu 
m 


5030 
10 


1.1 




T121 6: Analysis Tool to 
accept file path names 
on command line 
Analysis.exe must 
allow zero or more file 
path names on its 
command line. When 
Analysis.exe starts up it 
opens the files named 
on its command line 


P 
D 
L 


Lefebvre 

,c 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Partia 
1 

Accep 
t 


Mediu 
m 


5030 
10 


1.1 





'KNISYS^ESTRICTED CONS$0EI^^ 

C:\WINNT\Profi Ies\Alcm/aY\Dcskiop\AAM 1.0 Functional Spec.doc 
153 




Title: Application Asset Manager Server Consolidation Features 68763895-003 
Type: Functional Design Specification Version B 

Owner: Jonathan Ziebell 



Requirements 


Im 

Pl 

Or 

9 


Prod 
Engr Mgr 


Dvlpm 
nt Mgr 

[1- 

Flt:Y 

Srt:N] 


Product 
Area [2 - 
Flt:Y 
Srt:N] 


Catego 

ry 


Statu 
s 


Priorit 

y 


RDP 
Ref.# 


Plann 
ed 
Rel 
Lvl 


Tra . 

ced 

-to 


T1217: Implement 
Analysis property page 
for Server 

Consolidation folders 
The name of the 
Deployment property 
page will be changed to 
Analysis when the 
properties dialog is 
displayed for a Server 
Consolidation folder. 


P 
D 
L 


Lefebvre 

,C 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Partia 
1 

Accep 
t 


Mediu 
m 

• 


5030 
10 


1.1 




T1218: Server 
consolidation menu 
item in a server 
consolidation folders 
context menu 
When a Server 
Consolidation folder is 
selected in the AAM 
Shell tree view or list 
view its context menu 
will contain a Server 
Consolidation item 
instead of Deploy and 
Discover items. The 
Server Consolidation 
menu item in the 
context menu will be 
identical to the Server 
Consolidation menu 
item in the AAM Shell 
menu bar 


P 
D 
L 


Lefebvre 
,C 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Partia 
1 

Accep 
t 


Mediu 
m 


5030 
10 


1.1 




T1219: Implement 
Schedule feature for 
Deploy and Discover 
The Analyze and 
Discover dialogs will 
contain a "Schedule" 
button. When the 
Schedule button is 
pushed a file containing 
the process sequence 
will be written to the file 
system and an 
AAMDeploy or 
AAMDiscover task will 
be added to Windows 
Scheduler 


P 
D 
L 


Lefebvre 

,c 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Open 
(unde 
r 

evalu 
ation) 


Mediu 
m 


5030 
10 


1.1 





p 



UNISYS RESTRICTED CONFIDENTIAL 

C:\WINNTVProfiIcs\AlemzaY\Desktop\AAM 1.0 Functional Spec. doc 
154 



i 




Title: 


Application Asset Manager Server Consolidation Features 


68763895-003 


Type: 


Functional Design Specification 


Version B 


Owner: 


Jonathan Ziebell 





Requirements 


Im 

nl 

Or 
9 


Prod 
cnyr iviyr 


Dvlpm 

in iviyr 
[1- 

Flt:Y 
Srt:N] 


Product 
Area [2 - 
Flf.Y 
Srt:N] 


Catego 
ry 


Statu 
s 


Priorit 

y 


RDP 

□of 4i 
ntsi.tr 


Plann 

cU 

Rel 
Lvl 


Tra 
ced 
-to 


T1220: Analyze item in 
context menu of Server 
Consolidation folders 
When one or more files 
are selected in a 
Server Consolidation 
loiuer an Mnaiyze iiem 
will be added to the 
popup menu 


P 
D 
L 


Lefebvre 

,c 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Partia 
I 

Accep 
t 


Mediu 
m 


503O 
10 


1.1 




T1224: SQL query 
support in Analysis tool 
Implement SQL query 
capabilities for Analysis 
tool All orocesse*? in 
memory using OLE DB 
Provider for XML with 
data results persisted 
and versioned in AAM 
database. 


P 
D 
L 


Lefebvre 
,C 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Accep 
ted 


Mediu 
m 


5030 
10 






T1225: Online help for 
analysis tool query. 
Analysis tool. 
Implement online help 
which provides 'tutorial' 
for custom SQL query 
capabilities. 


P 
D 
L 


Lefebvre 

.c 


Stefani 
ak, J 


Platform 
Software 


Functio 
nality 


Accep 
ted 


Mediu 
m 


5030 
10 


1.1 





^^UNISVS RESTRICTED CONWBENT1AL 

C\WINN1\Pronies\ArcmzaY\Dcsktop\AAM 1 .0 Functional Spccdcc 
155 



3dL«h 



Title: 


AAM Database Discovery 


*• 


68905330 


Type: 


Functional Design Specification 




Version A 


Owner: 


Mac Vazehgoo 







Abstract: 



AAM SQL Server Database discovery is designed to facilitate SQL server Consolidation. It automates 
much of the information gathering and analysis process. It complements the information gathered through 
Process discovery. The information gathered is a detailed inventory of the customer's existing SQL Server 
estate - Servers, Instances, Databases, User and much more. The information collected is stored in 
Application Asset Manager database and is used by Analysis Manager during the analysis process. 

The target server is selected by a client through a GUI interface as part of the overall discovery process. A 
discovery agent is pushed on the target server with a privileged user account and starts collecting 
information into an XML file format on client machine. The XML file is stored in AAM database 
permanently with a tracking version. As part of the load process, the information in this file is read and 
transformed into a series of relational records and stored in a cache database for query purpose by Analysis 
Manager. The result of this effort is to assist with SQL Server Consolidation Process. 
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1. Document Control 

This document was generated using the PPG Template Generator, 3490 3880, revision J. 

1.1. Change History 



Version 


Description 


A 


Initial Revision being written. 















1.2. Document Cross Reference 

The supported functionalities that are documented in here are in reference to MSOR requirements. The 
following is a partial list of MSOR requirements that are being referenced within this document: 

MSOR Reference 906.1.8: Detect differences in schema objects for roles, users, aliases, defaults, rules, user 
functions, stored procedures, triggers, tables, indexes, user-defined types, views, messages. 

MSOR Reference 906. 1.7: Detect None-Defauit sp_configure settings 

MSOR Reference 906.2.1. 1: Collect database sizes (space used, allocated for data and log) 

MSOR References 906.2.1: Collect information on activity reporting (clients, logins, databases being 
used) 

MSOR 906.2.2.1: Capture current sort/collation sequence 
MSOR Reference 906.2.4: Identifying DTS packages 

MSOR Reference 906.2.6: What type of replication is being used (Transaction, Merge, etc) 
MSOR Reference 906.3.1: Identify non-standard modifications (user objects in master db) 
MSOR Reference 906.4: Identifying login conflicts (duplicate names and conflicting permissions) 



2. Introduction 

AAM SQL Server Database discovery is designed to facilitate SQL server Consolidation. It automates 
much of the information gathering and analysis process. It complements the information gathered through 
. Process discovery. The information gathered is a detailed inventory of the customer's existing SQL Server 
estate - Servers, Instances, Databases, User and much more. The information collected is stored in 
Application Asset Manager database and is used by Analysis Manager during the analysis process. 
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1 2.1. Purpose 

2 The purpose of this document is to describe the design and functionality of AAM SQL Database discovery 

3 process and how it is utilized for SQL Server Consolidation process. 

4 2.2. Scope 

5 This document describes what needs to be done in capturing the required database server information in 

6 order to support a committed list of MSOR requirements for SQL Server Consolidation process. In 

7 addition it covers functionalities desired by UK TCS that is also selected items from MSOR. 

8 The target server is selected by a client through a GUI interface as part of the overall discovery process. A 

9 discovery agent is pushed on the target server with a privileged user account and starts collecting 

10 information into an XML file format on client machine. The XML file is stored in AAM database 

1 1 permanently with a revision. As part of the load process, the information in this file is read and translated 

12 in *° a series of relational records and stored in a cache database for query purpose by Analysis Manager. 

13 2.3. Key Points 

* 4 Throughout this document we refer to 3 different databases. The referenced databases are the following: 

15 AAM DB: This is the Application Asset Manager database. 

16 Discovery DB: This is the inventory database that is used to store the information collected from target 

17 SQL servers. It is a relational database that resides on client machine. The database type is either a Jet db 

18 or SQL Server type DB. Connection to this database is a local connection and may require login account. 

19 Target SQL Server: This is the SQL Server instance where the inventory is taken from. 

20 Note: The database discovery process requires SQL admin privileges account on the target SQL server. 
21 

22 To connect to an instance of SQL Server, typically two or three pieces of information are required: 

23 * The network name of the computer on which the SQL Server instance is running. 

24 • The instance name (optional, required only if it is named instance). 

25 * Login identifier (ID). If this is not provided, a trusted connection is required which is 
2 *> authenticated by the SQL instance and should have been configured such. 

27 

28 3. Interdependences 



29 AAM Analysis Manager 

30 PSEXEC 



31 4. Functional Overview 

32 " rhls section describes the overall process managing the data gathering on the target server and storing them 

33 in an XML file. 

34 On client request and from AAM workbench, the Database Discovery process is spawned by PSEXEC 

35 program and is executed on the target server. When the process starts, the following occurs: 
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Captures the SQL Server name and version on the target machine. 
For each instance of the SQL server on target machine, 
For each database schema 

Collect schema information (tables, views, indexes, roles, etc) 
User logins, permissions and roles 
User objects in the master db 

Database names and logins and database client names 

SQL configuration settings 

Collation settings 

Jobs and task 

SQL alerts 

Replication 

DTS packages list 

Database size and log size information 
The following figure represents the process flow in capturing the data. 



PSEXEC 



On-Demand Database Discovery for a selected target server 



AAM 
Workbench 
Discovery 



Database 
Discovery 
Process 




The data collected in the XML file is later loaded into a relational schema for analysis purpose. The 
process for loading is not described in this document 



-Ian. r+ 
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4.1 . Discovery database Schema 



Logins 
0 Jam tea) 



EaJ 



hiaa_name : VARCHAR{256) 

Brvar_r\ame : VARCHAR(255) 
.oglnName : VARCmR(510) 
SJD:VABCHAfl(688) 
tefDSName : VABCHAR(510) 
tetLanoName *- VARCHAR(5iq) 
ber: VARCHAR<510) 
!emote:VARCHAR{5tQ> 



A 



InsUogtns 



1..n 



Databases 
(from test) 



JrtachineNama : VARCH*R{255> 
[ServerNama ; VARCHaR(25S) 
ame:VARCHAR(5l2) 
wnor: VAFtCHAR(512) ' 
reated : VARCHAR(5io) 
latus:VARCHAR(2400) 
ompatlbnityjevel : VARCHAR(51 0) 
|oq32o : REAL 
[flog space used : REAL 
HsiaUra : V ARCHAFK255) 
Idbsize : REAL 
[anal(oc_s: REAL 

»«fja:REAL 
foata_e: REAL 
undex_a: REAL 
Bd.sp : REAL 

publish : INT 

msfgepublidi : INT 
Jbownor : VARCHAR{255) 
readonly : VARCHAR(255) 



SQLJnsances 
ram test) 



[MachlneNama : VARCHARC255) 
[ServerName : VARCHARfcSS) 
JproduclName : VARCHARf255> 
JProductVereion : VARCHARJ255) 
Language : VARCHAR<255) 
JRIeDesdipUon : VARCHAR(255) 
IRlaVeraon : VARCHAR{255) 
nroetnalName : VARCHAR(255) 
|QtlginalRlaname : VARCHARC255) ' 
JprivateBuitd : VARCHAR<255) 
IsperialBuHd : VARCHAR(255) 
fwindowSVcision : VARCHAR(Z55) 
JprocasswCount : VARCHAR(255) 
iProccssorAcUvoMa*: VARCHAR(255) 
Iphyi* calMemoiy : VARCHAR(255) 
iCollatton : VARCHARC255) 
fedluon : VARCHAR(255) 
BSauaered : VARCHAR{255) 
Jld=ullT6xUnsla«9d : VARCHARJ255) 
JdMegratBdSecutftyOnly : VARCHARC25S) 
IlSSlnglaUser: VARCHAR(2S5) 
IISSyncWUhBacfeip : VARCHAR(255) 
XUcenseType : VARCHAR(255) 
PraductLovel : VARCHAR1255) 
3awo_enabled : INT 
jpax_sBiver_mamoiy_MB : INT 
Irrrtn sefV0r_m8rnoiy_MB : INT 
HShortProduClVeidon : CrtARW 



InsLAterts 



0..n 



lnst__DBFto!es 



Alerts 
flrotn ted) 



■i neName : VARCHARgS5) 
©werName : VARCHAR(25S> 
|nama : VARCHAR£56> 



Serve rRotes 
torn te^> 



iMadjlneName : VARCHAR(255) 
IseivaiNamB : VARCHAR{255) 
fSeivetRQla : VARCHAR$25&) 
|wcmberMame : VARCHARpSB) 
llMftmbatSlD : VARCHARC344) 





DB_Roles 

(from test) 

machlno^namo : VARCHAR{255) 
setveiLname : VARCHAR(255) 
LogmNarne : VARCHARI510) 
faBNama : VARCHAR©10) 
fosarNaine ; VARCHARI510) 
U»rOrAllas: VARCHARC510) 



DTS_Pacteges 
(from test) 



n 



neName : VAPCHARC255) 
ServerNamo : VARCHAR(25S) 
VARCHARI25B) 
r. VARCHAFU256) 



0..n 
Inst U$R..y, 


53 

Operators 
Pram test) 


KfiMacbirieNama : VARCHAR(255) 
HserverName • VARCHAR(25S) 
l^name : VARCHAR{256) 




S3 

USPMaSerDB 


MachlneName : VARCHAR(255) 
ServerName : VARCHAR12SS) 
USPName : VARCHAR12SS) 
OwneT:VARCHAR{255) 


0-n 





dachlnoName : VARCHAR£S5) 

:VARCHARp5S) 
prfBtnatlng_sefV9i : VARCHAFU255) 
i ; VARCHAR(256) 



Non_De1axnu^co" f, 9«» s 
(from tea) 



.vlachl neName ; VARCHAR(255) 
teorvarName : VARCHAR12S5) 
Name : VARCHAR(255) 
jatavtUValue : VARCHAR(255) 
Minimum : VARCHARt255) 
ixlmum : VARCHAR£55) 
wing_va)u9 : VARCHAR<255) 
rvalue : VARCHAR(255) 
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2 4.2. Major Functions 

3 Instances: This provides a collection of SQL server instances broken down by version information. 

4 Sp_configure: This provides non-default configuration parameters by server. MSOR Reference 906. 1.7 

5 Database sizes: This provides the amount of space actually being used by each database. MSOR 

6 Reference 906.2.1.1 

7 Collation: This provides the sort order and code pages being used by each SQL instance. MSOR 

8 906.2.2.1 

9 . Logins and Server roles: This provides details, of login names in the server population and their assigned 

10 default database names. Also collects information on server roles that may have been assigned to a login. 

11 DB roles: Collects the login's database roles. 

12 Jobs/Alerts/Operators/DTS packages: Gathers information for Jobs/Alerts/Operators and DTS packages 

13 on multiple servers. MSOR Reference 906.2.4 

14 Replication: Provides information on whether repJication is allowed for those databases. MSOR 

15 Reference 906.2 .6 

16 User stored procedures: Collects those user-stored procedures within the master database. MSOR 

17 Reference 906.3.1 (user objects) 

1 8 Login Activity: This provides the logins and the database and their active clients. 

19 MSOR References 906.2 including the Database sizes and Activity reporting items only. 

20 Login/Permission Conflicts: This report shows the duplicate login names with conflicting permission. 

21 MSOR Reference 906.4 

22 Schema Information: This provides schema scripts for databases within the target SQL server. 

23 MSOR Reference 906.1.8 
24 

25 Loading into Analysis Database: This includes reading XML file and populating Analysis database with 

26 the data collected. 
27 

28 5. Functional Description 

29 5.1 . Function DiscoverSchemalnfo 

30 MSOR 906.1 

3 1 The goal in here is the ability to detect differences between database objects for duplicate databases on 

32 multiple servers. The following database objects are captured for comparison: 

33 Roles, Users, Aliases, Defaults, Rules, Functions, User defined datatypes, User messages, Tables, Views, 

34 Indexes, Extended procedures, Stored procedures and Triggers. 

35 The extend of the differences are not known at this time but given that it is compared to what Embarcadero 

36 software provides, could be rather detailed. 

37 There are several methods available to achieve this goal. The method chosen for this implementation is to 

38 utilize T-SQL and inquiring the catalogue information from system tables. Other methods were considered 

39 as alternatives and is listed in the Appendix B. 
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2 5.2. Function GetDatabaseActivity 

3 MSOR 906.2 

4 The information on logins and databases and their active clients are collected through this function. 

5 SQL Server available system stored procedures are used to capture this information. We would use a join 

6 query against Sysprocesses and sysdatabases tables to capture the information. 

7 SELECT dbs.[name], [program_name],[loginame] FROM [ master]. [dbo). [sysprocesses] procs, 

8 [master].[dbo].[sysdatabases] dbs Where procs.[dbid] = dbs.[dbid] And Len([program_name]) > 0 
9 

10 5.3. Function GetUserObjects 

11 MSOR 906.3 

*2 The function interrogates Master db for any user objects. System Stored procedures are used to capture the 

13 data. The function looks for user type objects in the master database and .the ones found along with their 

14 description and contents is written to XML file to be stored in the cache database. 

15 SELECT CONVERT(char(32), host_name()) as MachineName, ServerName = CASE 

16 @ @servername WHEN null THEN CONVERT(char(32), host_name()) ELSE CONVERT(char(32), 

17 <§>@servername)END, o.name as StoredProcName, u.name as OwnerName FROM 

18 master..sysobjects o, master. .sysusers u WHERE o.uid = u.uid and o.type — TP* and o.category = 0 

19 and o.name o *sp_Jie!psqr 

20 5.4. Function GetDatabaselnfo 



21 MSOR 906.3 

22 To identify the potential login problems like duplicate names in more than one server and the conflicting 

23 permission, this function captures the logins and permissions via the stored procedures available. 

24 For each instance get the list of logins and their roles for each database within that instance. 
25 

26 5.5. Function GetConfigurationSettings 

27 The configuration information such as from sp_configure, is extracted, would be compared against the 

28 default settings for a particular version of SQL Server. We should save a default configuration of each 

29 version of SQL Server and compare the current setting against these default settings and report the 

30 differences. 

31 r 

32 5.6. Function GetSQLInstanceslnfo 

33 Here we collect ihe product version, edition, service pack. Collation, etc. 

34 We make use of SQL Server function ServerProperty to get some of this information. 

35 Select CONVERTtchar(32). se^ve^p^opertyCConation , ) )as 'Collation 1 . 

36 CONVERT(t;har(32). servcrpropertyCEdition^as 'Edition', 
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CONVERT(char<32), servcrproperty('£ngine Edition') )as 'Engine Edition', 
CONVERT(char(32), seIve^property('mstanceName , ) )as 'InstanceName\ 
CON VERT(char(32), scrveipropcrtyCIsClustered^as 'IsClustered\ 
CONVERT(char(32), scrverpropcrtyCIsFuIrTextinstaJled^as # IsFuirrextIiistalied\ 
CONVERT(char(32). serverpropertyC'IsIntegratedSecurityOnly'Mas 'lsIntegratedSecurityOnly', 
CONVERT<char(32), serverproperty( , bSingleUsej'))as , !sSingleUscr\ 
CONVERT(char(32), serverpropertyClsSyncWithBackup*))as , IsSyncWichBackup\ 
. CONVERT(char(32), serverproperty('LicenseType'))as 'UcenseType', 
CONVERT(char<32), scrvefpropcrtyCMachineName7)as , MachineName , f 
CONVERT(char(32), servenpropcrty CNumU censes'))as 'NumLicenses*, 
CONVERT(char(32). scrverpropertyCProcessID'))as *ProcesslD\ 
CONVERT(char(32), seTverproperty(Tn)ductVersion*))as r ProductVersion\ 
CONVERT(char(32), scrveTproperty('ProduclLevel , ))as TtoductLevel', 
CONVERT(char(32), serverproperty('ServerName'))as 'ServerName' 
For non-2k SQL server some of these fields will be null. 

i6 5.7. Function GetSQLJobsTasksAnd Alerts 



The purpose of this function is to capture list of Jobs, Alerts and Operators for an Instance. 

List jobs via sysjobs table of msdb: 

Select CONVERT(char(32), hosOunneO) as MachineName, ServerName = CASE ©©servemame WHEN null THEN 
CONVERTXchar(32), hosCnaraeO) ELSE CONVERT<char<32), ©©serveraame) END * from msdb..sysjobs 

List Alterts via sys Alerts table of msdb: 

SELECT CONVERT(char(32), hostjiameO) as MachineName, ServerName = CASE ©©servcrname WHEN null THEN 
CONVERT(char(32). hosc_name0) ELSE CONVERT(char(32). @ ©servername) END,[id],[Namc].EvcnU;ource. 
Event_categoryJd, Evened, Messagejd, Severity, Enabled ,DeIay_between_responses, Last^occurrcnce__date, 
Lasuoccurrence^time, Lastjtsponse_date, Last_response_time, Notification_raessage, lnclude_evcnt_description, 
Database_namc. Event.descripUon_keyword. Occurrence_count, Count_reset_date, CounoesetLtimerjobJd, Has_notification, 
Flags, Performancc_condition, Categoryjd, M as Evenecategory_name. " as Delay_berween_jiotificaoons. " as Tasked, M as 
Has_emajLnotification, rt as Has_pager_notification FROM msdb..sysa!erts 

• 

List Operators via sysOperators of msdb: 

DECLARE ©SQLVersion varchar(4) * • 

SELECT ©SQLVersion = SUBSTRING(@ @ version, 23, 4) 
-Extract the information, dependant on SQL version 
IF (©SQLVersion = '65V) 

SELECT CONVERT(char(32), host_name0) as MachineName, ServerName = CASE ©©servcrnamc WHEN null THEN 
CON VERT(char(32), hosijiameO) ELSE CONVERT(char(32), @@ servername) END.*, rt as Nels<:nd__address, * as 
Lasi_neisencLdate. " as LasL_netsend__tirne, M as Category Jd FROM msdb.^ysoperators 

ELSE 

IF ( ©SQLVersion = 7.00*) or (©SQLVcrsion = '2000) 

SELECT CON VERT(char(32), host_namc<)) as MachineName, ServerName = CASE ©^scrvemame WHEN null 
THEN CONVFJ*T(char(32),hosUiameO) ELSE CON VERT(char(32). ©©servemame) END/ FROM msdh..sysopcrators 
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1 5.8. Function GetReplicationAndDTSpackages 

2 Collect info on databases where replication is allowed. Report in a list, server, instance and dbnames along 

3 with replication role (Publisher, Distributor, Subscriber) and replication type. The system Store procedure 

4 l sp_helpreplicationdboption' is utilized to capture replication information. To capture DTS packages info, 

5 the following SQL statement is exercised: 

6 DECLARE ©SQLVeision varchar<4) I 

7 DECLARE ©SQLString varchar(255) 

8 SELECT ©sqlversion = SUBSTRING(® ©version, 23, 4) 

9 IF (©SQLVersion = '6.50") 

10 select" 

11 ELSE 

12 IF (©SQLVersion = •7.00*) 

13 IF @ ©ServerName is not Null 

14 SELECT ©SQLString = 'SELECT CONVERT(char(32). hosi_name()) as MachineName, 

J5 CONVERT(char(32) t @ ©servemame) as ServerName,naine, id, version id ,cast( description AS char(25)) as ShortDescription, 

1" categoryid.createdate.owner, owner_sid, as PackageType from msdb.sysdts packages' 

17 ELSE 

] SELECT ©SQLString = 'SEUSCT CONVERT(char(32), hosi_name()) as MachineName, 

19 CONVERT(char(32), hosl_name()) as ServerName,name,id,versionid,cast(dcscription AS char(25)) as ShortDescription. 

20 categoryid,crcatedate,owner, owner_sid, " n as PackageType from msab^ysdispackages* 

21 ELSE 

22 ' - ^©SQLVersion^OOO' 

23 IF © ©ServerName is not Null 

24 SELECT ©SQLString = 'SELECT CONVERT(char(32). host_name0) as MachineName, 

25 CONVERT(char(32) f @ ©scrvernamc) as ServerName f name,id t versionid,cast(description AS char(25)) as ShortDescription, 
2o categoryid,createdate,owner, owner_sid,packagerype from msdb..sysdtspackagcs > 

27 EISE 

28 SELECT ©SQLString = 'SELECT CONVERT(char(32), host_name0) as MachineName, 

29 CONVERT(char(32), host_name()) as ServerName,name,id,vereionid,cast(description AS char(25)) as ShortDescription, 

30 categoryid,createdate,owner, owner_$id,packagetype from msdb. .sysdts packages' 

31 EXEC(@SQLString) 
32 

33 

34 5.9. Function GetSQLDatabaseDiskUsage 

35 We get the db size and log size for each database. Here we get the dbsize (used and free), logsize (used 

36 and free). Report it with server/instance/dbname. 

37 Disk space utilization: Compare server disk space allocated with used spaces for all dbs. 

38 Here is a sample code to go to each database and execute stored procedure 'sp_spaceused' to capture some 

39 of the information. 

40 DECLARE AIIDatabases CURSOR FOR SELECT name FROM sysdatabases - WHERE dbid > 4 

41 OPEN AIIDatabases 

42 DECLARE ©DBNameVar V ARCHAR( 1 28) 
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DECLARE ©Statement VARCHAR(255) 

FETCH NEXT FROM AUDatabases INTO ©DBNameVar 

WHILE (@@FETCH_STATUS = 0) 

BEGIN 

SELECT ©Statement = USE 1 + ©DBNameVar + CHAR(13) 

+ ' exec sp_spaceused' 
EXEC (©Statement) 

FETCH NEXT FROM AUDatabases INTO ©DBNameVar 
END 

CLOSE AUDatabases 
DEALLOCATE AUDatabases 
To capture log size information, the following SQL statement is utilized: 
DBCC SQLPERF(LOGSPACE) WITH NOJNFOMSGS 

5.10. Function Analysis And Reporting 

A set of standard reports is provided which queries the Discovery database. The result is presented as grid 
and charts as appropriate. Additional reports can be constructed either via the query window or via . 
standard SQL based query tools as required. The supplied reports must provide the following data: 

Instances: This provides a quick view of the total number of SQL server instances broken down by version 
information. 

Sp_configure: This shows non-default configuration parameters by server. 

Unique DBs: This report lists the unique database names in the server population and gives a count and the 
name of the servers hosting the database. 

Database sizes: This report shows the amount of space actually being used by each database. 
Collation: This report indicates the sort order and code pages being used by each SQL instance. 
Logins: This report details the unique login names in the server population. 

Default DB Conflict: This report lists those users who have logins on more than one server but assigned 
' with a different default database. 

Server roles: This shows the different server roles that may have been assigned to a login. 

Server role Conflicts: Showing those identical logins on multiple servers but with different server roles. 

DB roles: Report the login's database roles. 

Jobs/Alerts/Operators/DTS packages: Reporting the information for Jobs/ Alerts/Operators and DTS 
packages on multiple servers. 

Replication: Listing those databases where replication is allowed. 

User stored procs: Listing those user stored procedures within the master database. 

Login Activity: This report shows the logins and the database and their active clients. 

Login/Per mi ssion Conflicts: This report shows the duplicate login names with conflicting permission. 

Schema Conflicts: The report shows those duplicate named databases with conflicting schema objects. 
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i 6. User Interfaces 



5 

6 < add a picture snapshot from workbench discovery in here > 
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6.1. Interface <name> 




2 


6.1-1. Overview 




3 


6.1 .1 .1 .Purpose of Interface 




4 


6.1 .1.2. Functions 




5 


6.1.1.3.Form 




6 


6. 1.2. User Manual 




7 


6.1. 3. Additional Information 




8 


6.1 .3.1. Security and Integrity 




9 


6.1.3.2.Diagnostic and Debug Methods 




10 


6.1 .3.3.Performance 




11 


6.1.3.4.Future Enhancements 




12 


7. System Software Interfaces 




13 


7.1. Interface <name> 




14 


7.1.1. Overview 




15 


7.1 .1 .1 .Purpose of Interface 




16 


7.1.1 .2. Functions 




17 


7.1.1.3.Form 




18 


7.1. 2. Interface Description 




19 


7.1. 3. Additional Information 




20 


7.1 .3.1 .Security and Integrity 




21 


7„1.3.2.Dragnostic and Debug Methods 


V . 


22 


7.1 .3.3.Performance 




23 


7. 1.3.4. Future Enhancements 
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1 8. Future Interfaces 

2 9. Standards and Conformance 

3 10. Release and Installation Procedures 

4 11. Significantly Altered or Deleted Features 

5 12. Issues and Risks 



6 
7 
8 

9 

10 

11 
12 



13 
14 

15 



Schema discovery could be a problem in here. Discovering very large databases such as SAP could cause 
the discovery process to run for a few hours if it succeeds and also storing the discovered schema into 
Analysis database due to its size is another issue that has not been investigated fully. 

13. Coding Estimates 

The estimates are for code to implement the feature and load into Analysis database. It does not include 
Analysis Manager work and integration testing. 



Task Name 


Estimated days to complete 


Get Instances information 


3 


Get non-default instance's configuration 


5 


Get Database sizes (data and log space) 


. 3 


Get Collation 


1 


Get Logins and Permissions 


4 


Get Server roles 


I 


Get DB roles 


1 


Get Jobs/Alerts/Operators/DTS packages 


2 


Get Replication 


1 


Get User stored procedures 


3 


Get Database/Login Activity 


4 


Get Schema Information 


20 


Loading into Analysis database 


7 
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Appendix A. Definitions, Acronyms, and 
Abbreviations 



This is a sample entry 



Use the Gloss" paragraph style. Place the term or expression to be defined on the first line. Then enter 1 
or 2 line breaks (<SHIFr> <ENTER>)- not paragraph breaks. Next enter the definition. The key is to 
keep one entry as one paragraph. If this is done, you can select all of the glossary entries and use the 
Sorting function (under the Table menu) to alphabetize them. 



o 
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, Appendix B. Alternatives Considered 

2 To collect schema information, the following methods were considered but they were not selected. 

3 One method to get this information is to utilize SQL-DMO scripting method for the schema This would 

4 createameforagivendaubase^^ file then canbo 

5 read into the XML file and stored as an image in the cache database. During the Analys.s, when comparmg 

6 two databases for their differences, we could read the images for the databases into files and run a Diff 

7 command and report the Diff file to the client. The issue in here is creaung files on .the server and I XML. 

8 fiTgetting larger. Alternative to keeping the large schema script file m the XML file wouW be to keep 

9 Sen? in separate files and have a reference in the XML file to the schema filename. Tins of 'oursecauses a 

10 major maintenance problem within AAM to keep the related files together and from removmg them 

1 1 partially. 

12 Another method would be to just call SQL-DMO cataloging information. We could <^"£*™£ A& 

3 database objects one at a time and storing them in appropriate fields ,n *e cache database. Jurmg the 

4 Analysis however, stored procedures required to scan two databases schema utformauon and compare £em 

5 for any difference;. Next is to somehow show the differences report W.th this approach a major work is 
16 required lo come close to what a Diff command reports when comparing two files. The mformauon detads 
L7 are extensive. 

18 
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Appendix C. Database Schema 
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1 Here is the XML layout for the Schema information part only. 
2 

3 For each database within an SQL instance, there is an element called <SchemaInfo> containing the information. 
4 

5 <SchemaInfo 

6 <iTableInfo 

7 <ColumnInfo name = "columnName goes here** 

8 Description = "column description goes here" /> 

9 <ColumnInfo name = "col umnName goes here** 

10 Description = "column description goes here" /> 

1 1 <ColumnInfo name = "columnName goes here** 

12 Description = "column description goes here" h> 

13 

14 more columns 

15 <rTriggerInfo name = "triggerName " Description = " trigger description** /> 

16 

17 additional triggers ' 

18 

19 <ConstraintInfo name = "constraintName " 

20 Description = "constraint description" /> 

21 

22 additional constraints 

23 

24 <IndexInfo name = "indexName " Description » "index description" /> 

25 

26 additional indexes . 

27 

28 </TableInfo> 

29 

30 additional tables go here 

31 

32 <ViewInfo name = "viewName goes here" 

33 Description = "view description goes here" </ViewInfo> 

34 

35 more views 

36 

37 <UdtInfo name = "UDTName goes here*' 

38 Description = "UDT description " <flJdtInfo> 

39 

40 ~. more user-defined types 

42 <FunctionInfo name = 4t functionName goes here" . 

43 Description = "function description goes here" </Functionlnfo> 

44 

45 more user-defined functions 

46 

47 . <SPInfo name = "stored-procedureName goes here" 

48 Description = "Slored-procedurc description goes here" </SPInfo> 

49 

50 more user stored-defined procs 

51 

52 <DefaultsInfo name = "defaultName goes here" 

53 Description = "default description goes here'* </DefaultInfo> 

54 ' 
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I : more defaults in here 

2 

3 <RuleInfo name = "ruleName goes here" 

4 Description = "rule description goes here" </RuteInfo> 

5 

6 more rules in here 

7 

8 <UserInfo name = "userName goes here" 

9 Description = "user description goes here" </UserInfo> 

10 

11 more user info in here 

12 

13 <UserMsgInfo name = "userMsgName goes here" 

14 Description = "dserMsg description goes here" </UserMsgInfo> 

15 

16 more user messages info in here 

17 

18 </SchemaInfo> 
19 
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Appendix D. Functional Design Summary 



Require- 
ment ID 


Requirement 


Commit- 
ment 


Source 


Function 












— 





























































UNISYS RESTRICTED CONFIDENTIAL 

C:\WINNTVProfiles\A!cmzaYU)csktnp\AAM 2.0 DB Discovery Functional Specdoc 

180 



This Page is inserted by IFW Indexing and Scanning 
Operations and is not part of the Official Record 



BEST AVAILABLE IMAGES 

Defective images within this document are accurate representations of the 
original documents submitted by the applicant. 

Defects in the images include but are not limited to the items checked: 

□ BLACK BORDERS 

□ IMAGE CUT OFF AT TOP, BOTTOM OR SIDES 

□ FADED TEXT OR DRAWING 

e/ BLURED OR ILLEGIBLE TEXT OR DRAWING 

□ SKEWED/SLANTED IMAGES 

□ COLORED OR BLACK AND WHITE PHOTOGRAPHS 

□ GRAY SCALE DOCUMENTS 

□ LINES OR MARKS -ON ORIGINAL DOCUMENT 

□ REPERENCE(S) OR EXHIBIT(S) SUBMITTED ARE POOR QUALITY 

□ OTHER: 



IMAGES ARE BEST AVAILABLE COPY. 
As rescanning documents will not correct images 
problems checked, please do not report the 
problems to the IFW Image Problem Mailbox 



